todo-archive
installsforks
How to install todo-archive?
paulrberg/agent-skills/todo-archive
$npx -y skills add PaulRBerg/agent-skills --skill todo-archiveArchive checked TODO.md tasks into .ai/todos/TODO_UNTIL_YYYY_MM_DD.md, leaving unchecked tasks.
SKILL.md
| 1 | # TODO Archive |
| 2 | |
| 3 | `TODO.md` and `.ai/` are conventionally git-ignored, so they are untracked and `git diff` shows nothing for them. |
| 4 | Inspect changes against the filesystem, not git. |
| 5 | |
| 6 | ## Arguments |
| 7 | |
| 8 | - `path` (optional): Repository root or any path inside the repository. Default to the current directory. |
| 9 | - `--hint TEXT` (optional): Archive only the section whose heading contains `TEXT` (case-insensitive substring), |
| 10 | including its subsections. Without it, archive checked tasks from the whole file. Checked tasks outside the matched |
| 11 | section stay in `TODO.md`. |
| 12 | - `--date YYYY-MM-DD|YYYY_MM_DD` (optional): Archive date. Default to today's local date. |
| 13 | - `--dry-run` (optional): Preview target paths and rendered content without writing. |
| 14 | - `--force` (optional): Overwrite the date-only archive in place instead of rolling a same-day re-run over to a |
| 15 | timestamped file. |
| 16 | |
| 17 | ## Workflow |
| 18 | |
| 19 | 1. Resolve the repository root: |
| 20 | |
| 21 | ```sh |
| 22 | git rev-parse --show-toplevel |
| 23 | ``` |
| 24 | |
| 25 | If the command fails, use the provided `path` or current directory as the root. |
| 26 | |
| 27 | 2. Verify `TODO.md` exists at the root. If it is missing, stop and report the path checked. |
| 28 | |
| 29 | 3. Run the helper from this skill directory: |
| 30 | |
| 31 | ```sh |
| 32 | uv run python scripts/archive_todo.py --root "$repo_root" |
| 33 | ``` |
| 34 | |
| 35 | Pass through `--hint`, `--date`, `--dry-run`, or `--force` when the user requested them. |
| 36 | |
| 37 | 4. Report the rewritten `TODO.md`, the created archive path, the matched section (when `--hint` was given), and the |
| 38 | archived/remaining task counts. If an archive for the date already exists, the helper rolls the new batch over to |
| 39 | `TODO_UNTIL_YYYY_MM_DD_HHMM.md` and keeps the earlier file; report both paths. If the helper reports no checked |
| 40 | tasks, treat it as a no-op. If `--hint` matches no heading, the helper exits non-zero and lists the available |
| 41 | sections; relay them. When `--force` replaces an existing archive, say `⚠️ Overwrote existing archive`, never |
| 42 | `Created`. |
| 43 | |
| 44 | 5. If useful, inspect only the touched paths. `TODO.md` and `.ai/` are git-ignored, so use the filesystem rather than |
| 45 | `git diff`: |
| 46 | |
| 47 | ```sh |
| 48 | cat TODO.md && ls .ai/todos/ |
| 49 | ``` |
| 50 | |
| 51 | ## Helper Behavior |
| 52 | |
| 53 | `scripts/archive_todo.py` reads only `<root>/TODO.md`, writes archived tasks to |
| 54 | `<root>/.ai/todos/TODO_UNTIL_YYYY_MM_DD.md`, and rewrites `<root>/TODO.md` with the remaining tasks (a minimal `# TODO` |
| 55 | stub if everything was archived). With `--hint`, it restricts archiving to the matched heading's subtree and exits |
| 56 | non-zero listing available headings when nothing matches. It rolls a same-day re-run over to a timestamped |
| 57 | `TODO_UNTIL_YYYY_MM_DD_HHMM.md` sibling instead of clobbering the earlier archive, unless `--force` is passed. |
| 58 | |
| 59 | ## Completion |
| 60 | |
| 61 | Completion evidence is the helper's archive path plus archived and remaining task counts; a no-checked-task result is a |
| 62 | successful no-op. Dry-run completion requires rendered paths/content with no filesystem changes. Finish with |
| 63 | `### 📦 Archived <count> checked tasks` and concise TODO/archive/scope/count rows; use |
| 64 | `### ✅ Nothing to archive — no files written` for a no-op and `### 🔎 Archive preview — no files written` for dry runs. |
| 65 | Do not repeat full dry-run document content in the final message or add decoration to TODO/archive files, paths, |
| 66 | commands, or helper diagnostics. |
People who liked this also viewed
6 picksType
- lark-drive飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sSkillsJul 2026
- lark-sharedUse for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handlingSkillsJul 2026
- lark-whiteboard飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。 当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责：飞书云文档内容编辑（lark-doc）、文档内嵌电子表格/Base（lark-sheets / lark-base）。SkillsJul 2026
- lark-task飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册注销任务智能体、更新智能体主页数据、写入任务记录时使用。SkillsJul 2026
- lark-attendance飞书考勤打卡：查询自己的考勤打卡记录SkillsJul 2026
- lark-apps妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用角色与成员管理、自动化触发器（定时/记录变更/Webhook/飞书审批）。当用户要SkillsJul 2026
