[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DDPQ25Y5QJH3Z1MGGKRM8J":3,"skill-same:01M7DDPQ25Y5QJH3Z1MGGKRM8J":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M7DDPQ25Y5QJH3Z1MGGKRM8J","todolist",null,"Manages bidirectional, persistent daily planning and task tracking between human user and AI agent using an ephemeral root file `TODOLIST.md`. Enforces hyper-detailed, atomic task decomposition so instructions are unambiguous, self-contained, and verifiable. Prevents losing track, scope drift, and rabbit-hole traps during complex coding sessions, tracks real-time progress, and automatically deletes `TODOLIST.md` once all tasks are completed. Use whenever the user shares a plan for the day, lists tasks to accomplish, asks to \"create a todolist\", \"track my todos\", \"check todo\", \"update todolist\", \"add to todolist\", \"show todos\", or when starting multi-task work to stay on track.","Marvellbrazil\u002Fmy-agentic-skills","Marvellbrazil","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F184349613?v=4","01M7DCJPCRHP7SZS0T5H1GJZ8F","Marvello Faisal","01M7DCJPDCZDB94VG0QXGC6RC3",5,"MIT","https:\u002F\u002Fgithub.com\u002FMarvellbrazil\u002Fmy-agentic-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftodolist\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: todolist\ndescription: Manages bidirectional, persistent daily planning and task tracking between human user and AI agent using an ephemeral root file `TODOLIST.md`. Enforces hyper-detailed, atomic task decomposition so instructions are unambiguous, self-contained, and verifiable. Prevents losing track, scope drift, and rabbit-hole traps during complex coding sessions, tracks real-time progress, and automatically deletes `TODOLIST.md` once all tasks are completed. Use whenever the user shares a plan for the day, lists tasks to accomplish, asks to \"create a todolist\", \"track my todos\", \"check todo\", \"update todolist\", \"add to todolist\", \"show todos\", or when starting multi-task work to stay on track.\nallowed-tools: Bash Read Grep Glob Edit Write\n---\n\n# To-do List for Agents (TODOLIST.md)\n\nKeep developers and AI agents aligned, focused, and immune to rabbit-hole traps through an ephemeral, shared, and **atomic** `TODOLIST.md` file located at the repository root.\n\n---\n\n## Why This Exists\n\nDuring engineering sessions, three common failure patterns derail progress:\n1. **The Vague Task Trap**: High-level todos like *\"Implement authentication\"* or *\"Fix checkout bug\"* hide 10 unspoken sub-decisions. When an agent or developer starts executing a vague item, they have to figure out architecture, file paths, and verification on the fly — leading to half-baked implementations or stalls.\n2. **The Rabbit-Hole Trap**: While working on Task A, an obscure error or tempting refactor appears. The session spirals into micro-optimizations, the remaining plan is forgotten, and work stops prematurely with Tasks B and C abandoned.\n3. **The Invisible State Problem**: AI agents have internal memory and scratchpads, but these are opaque to the human developer in their IDE. The developer cannot see the plan, cannot adjust granularity or priority, and cannot tell if the agent has drifted off-course.\n\n`TODOLIST.md` solves all three problems:\n- **Atomic & Self-Contained**: Every task is broken down into small, unambiguous, independently verifiable units specifying exact target files, concrete changes, and verification commands.\n- **Shared & Accessible**: Lives right in the project root where the developer can inspect, edit, or reorder tasks in their own editor.\n- **Anchor Against Drift**: After every completed atomic step, the agent re-anchors itself to `TODOLIST.md` before picking the next task.\n- **Clean Ephemerality**: The file exists *only* while tasks are active. The moment all tasks are completed and verified, `TODOLIST.md` is automatically deleted, leaving zero clutter in the git tree.\n\n---\n\n## Atomicity & Detail Standard (Mandatory)\n\nNever write vague, coarse-grained tasks. Before writing `TODOLIST.md`, briefly inspect the relevant files so every task item carries concrete, actionable instructions.\n\n### The 4 Rules of Atomic Tasks\n1. **One Concern Per Item**: Each checkbox (`- [ ] **#1.1**`) must represent a single, cohesive change (e.g., one schema migration, one function\u002Fendpoint implementation, one component state wiring, or one test suite addition) that can be completed and verified in a single focused turn.\n2. **Explicit Target Locations**: Name the exact file path(s), function\u002Fclass symbols, or routes to create or modify (e.g., `src\u002Fauth\u002Fsession.ts -> revokeSession()`, not *\"in the auth module\"*).\n3. **Concrete Implementation Instructions**: State *what* must change and *how* — input\u002Foutput shapes, validation rules, error handling, edge cases, and invariants. Another engineer or fresh agent reading `TODOLIST.md` cold must be able to execute the item without guessing.\n4. **Executable Verification (\"Done When\")**: Every atomic task must specify how to prove it works (e.g., a specific test command, typecheck, CLI invocation, or expected response).\n\n### Bad (Vague) vs. Good (Atomic & Detailed)\n\n| Bad (Coarse & Ambiguous) | Good (Atomic, Detailed & Verifiable) |\n| :--- | :--- |\n| `- [ ] **#1** Add rate limiting to API` | `- [ ] **#1.1** Create sliding-window rate limiter middleware in \\`src\u002Fmiddleware\u002Frate-limit.ts\\` using Redis key \\`rl:{ip}:{route}\\`, limiting to 60 req\u002Fmin and returning HTTP 429 with \\`Retry-After\\` header.`\u003Cbr>`- [ ] **#1.2** Wire \\`rateLimitMiddleware\\` into public auth routes (\\`POST \u002Fapi\u002Fauth\u002Flogin\\`, \\`POST \u002Fapi\u002Fauth\u002Fregister\\`) in \\`src\u002Froutes\u002Fauth.ts\\`.`\u003Cbr>`- [ ] **#1.3** Add integration tests in \\`tests\u002Fmiddleware\u002Frate-limit.test.ts\\` covering under-limit (200), at-limit boundary, and over-limit (429 + header) cases.` |\n| `- [ ] **#2** Fix pagination bug` | `- [ ] **#2.1** Clamp \\`limit\\` parameter in \\`src\u002Forders\u002Frepository.ts -> listOrders()\\` to \\`Math.min(Math.max(1, limit ?? 20), 100)\\` and fix off-by-one cursor offset when \\`cursorId\\` is passed.`\u003Cbr>`- [ ] **#2.2** Add regression test in \\`tests\u002Forders\u002Frepository.test.ts\\` verifying \\`limit=0\\`, \\`limit=500\\`, and sequential cursor pages return non-overlapping items.` |\n\n---\n\n## The Lifecycle Contract\n\n```text\nUser states plans \u002F tasks\n          │\n          ▼\n   Quick reconnaissance (identify files & scope)\n          │\n          ▼\n   Decompose into atomic steps & create TODOLIST.md ◄──────┐\n          │                                                │\n          ▼                                                │\n   Execute Atomic Task #1.1                                │\n          │                                                │\n          ▼                                                │\n   Verify Task #1.1 & mark [x] in TODOLIST.md              │\n          │                                                │\n          ▼                                                │\n   Are all tasks [x] complete?                             │\n     ├── NO  ──► Focus on next pending atomic task         │\n     └── YES ──► Delete TODOLIST.md cleanly                │\n                         │                                 │\n                         ▼                                 │\n                  Clean Workspace                          │\n                         │                                 │\n                         └──── New tasks later? ───────────┘\n```\n\n### Core Rules\n1. **Always in Repository Root**: The file must be named `TODOLIST.md` and located in the workspace root.\n2. **Two-Way Synchronization**:\n   - The agent updates `TODOLIST.md` as tasks transition (`[ ]` pending -> `[\u002F]` in progress -> `[x]` done).\n   - If the user modifies `TODOLIST.md` in their editor, the agent respects the user's edits as the source of truth.\n3. **One Active Atomic Task at a Time**: Mark the currently active atomic item with `[\u002F]` and state it in the `Current Focus` section. Never multitask across multiple items simultaneously.\n4. **Verify Before Checking Off**: Never mark a task `[x]` until its `Verify` step has actually been executed and passed.\n5. **Auto-Deletion on Completion**: When the last remaining task is marked `[x]` and verified, the agent **must delete `TODOLIST.md`**.\n6. **Fresh Re-creation**: If new tasks are introduced in a subsequent session or turn, create a fresh `TODOLIST.md`.\n\n---\n\n## TODOLIST.md Template Format\n\nWhen creating `TODOLIST.md`, decompose the user's request into logical parent groups (`### #1 ...`) containing atomic, detailed sub-tasks (`- [ ] **#1.1** ...`):\n\n```markdown\n# Session To-Do List\n\n> **Goal**: [Clear 1-sentence summary of the session's objective and end state]  \n> **Status**: Active ([X]\u002F[Y] Atomic Tasks Completed)  \n> **Created**: YYYY-MM-DD  \n\n---\n\n## Tasks\n\n### #1 [Milestone \u002F Feature Area 1 Title]\n- [ ] **#1.1** **[Short Action Title]**\n  - **Files**: `path\u002Fto\u002Ffile.ts` (`symbolOrFunctionName`)\n  - **Action**: [Specific, unambiguous instructions: exact inputs\u002Foutputs, logic changes, validation rules, and edge cases to handle]\n  - **Verify**: [Exact command or check to prove completion, e.g., `npm test -- path\u002Fto\u002Ffile.test.ts`]\n- [ ] **#1.2** **[Short Action Title]**\n  - **Files**: `path\u002Fto\u002Fother.ts`, `tests\u002Fpath\u002Fto\u002Fother.test.ts`\n  - **Action**: [Specific implementation and test cases to add]\n  - **Verify**: [Exact verification command and expected outcome]\n\n### #2 [Milestone \u002F Feature Area 2 Title]\n- [ ] **#2.1** **[Short Action Title]**\n  - **Files**: `path\u002Fto\u002Fmodule.py`\n  - **Action**: [Specific instructions]\n  - **Verify**: [Exact verification command]\n\n---\n\n## Current Focus\n- **Active Task**: **#1.1** — [Short Action Title]\n- **Target Files**: `path\u002Fto\u002Ffile.ts`\n- **Done Criteria**: [What exact test or check proves this atomic step is finished]\n\n---\n\n## Completed\n*(Completed atomic tasks are logged here with verification evidence)*\n\n---\n\n\u003C!-- AUTOMATIC CLEANUP CONTRACT:\nThis file is temporary. When all atomic tasks above are checked [x], the agent will automatically delete TODOLIST.md.\n-->\n```\n\n---\n\n## Operational Commands\n\n### 1. Initialize or Intake (`\u002Ftodolist init` or `\u002Ftodolist \u003Ctasks>`)\n1. Read the user prompt for task descriptions, milestones, or plans.\n2. Perform a fast, read-only scan (`Glob`\u002F`Grep`\u002F`Read`) of the affected codebase areas so you can name real file paths, symbols, and test commands instead of placeholders.\n3. Decompose high-level requests into atomic sub-tasks (`#1.1`, `#1.2`, `#2.1`, ...) following the **Atomicity & Detail Standard**.\n4. Create `TODOLIST.md` at the repository root using the standard template.\n5. Output a concise summary confirming the atomic task count and immediately begin **#1.1** (or wait for confirmation if the user only asked to plan).\n\n### 2. Update Progress (`\u002Ftodolist progress` or inline execution)\nAs each atomic task is worked on and completed:\n1. Before starting an item, mark it `- [\u002F]` and set it under `## Current Focus`.\n2. Execute the code\u002Ftest changes described in `Action` and run the `Verify` check.\n3. Re-read `TODOLIST.md` to ensure no user edits are overwritten.\n4. Update the completed task checkbox from `- [\u002F]` to `- [x]`.\n5. Append a concise completion record under `## Completed` with verification proof (e.g., `- [x] **#1.1** Add sliding-window rate limiter — verified via vitest (4\u002F4 passing)`).\n6. Update `## Current Focus` to point to the next pending atomic item.\n7. Check if all items are complete.\n\n### 3. Check for Full Completion & Automatic Deletion\nWhen updating `TODOLIST.md`:\n1. Scan all checkboxes under `## Tasks`.\n2. If any unchecked `- [ ]` or in-progress `- [\u002F]` item remains: keep `TODOLIST.md`, inform the user of progress, and proceed to the next atomic item.\n3. If **100% of atomic tasks are marked `- [x]`**:\n   - Inform the user that all planned items are complete and verified.\n   - Delete `TODOLIST.md` (`rm TODOLIST.md` or file removal tool).\n   - Announce: `All todos completed and verified. TODOLIST.md has been removed.`\n\n### 4. Append or Split Tasks (`\u002Ftodolist add \u003Ctask>`)\n- If a new requirement emerges, decompose it into atomic steps (`Files`, `Action`, `Verify`) and append to `## Tasks`.\n- If an existing task turns out to be larger than expected during execution, **split it in place** into `#N.1`, `#N.2`, `#N.3` in `TODOLIST.md` before continuing, and update the total count in `Status`.\n\n### 5. Inspect \u002F Status (`\u002Ftodolist status`)\n1. Read `TODOLIST.md`.\n2. Report:\n   - Completed atomic tasks: `X\u002FY`\n   - Current active task and its verification target\n   - Next queued atomic tasks\n\n---\n\n## Agent Behavioral Discipline\n\n- **Decompose before executing**: If the user gives a broad goal (\"build feature X and fix bug Y\"), never copy-paste those two lines as two giant checkboxes. Break them down into 4–10 crisp, atomic steps with real file paths and verification commands first.\n- **Never ignore the list**: When you finish an atomic step, do not ask \"What should I do next?\" without checking `TODOLIST.md` first. Read `TODOLIST.md`, pick the next pending atomic item, mark it `[\u002F]`, and continue.\n- **Resist Scope Creep**: If you notice an unrelated bug or tempting cleanup during an atomic task:\n  - Do NOT derail the current atomic task.\n  - Either log it as a new pending atomic task at the end of `TODOLIST.md` (if in scope) or ask the user whether to add it.\n- **Preserve User Edits**: The user may open `TODOLIST.md` in their IDE to tweak instructions, reorder tasks, or add notes. Always read `TODOLIST.md` immediately before writing to merge state cleanly.\n","# To-do List for Agents (TODOLIST.md)\n\nKeep developers and AI agents aligned, focused, and immune to rabbit-hole traps through an ephemeral, shared, and **atomic** `TODOLIST.md` file located at the repository root.\n\n---\n\n## Why This Exists\n\nDuring engineering sessions, three common failure patterns derail progress:\n1. **The Vague Task Trap**: High-level todos like *\"Implement authentication\"* or *\"Fix checkout bug\"* hide 10 unspoken sub-decisions. When an agent or developer starts executing a vague item, they have to figure out architecture, file paths, and verification on the fly — leading to half-baked implementations or stalls.\n2. **The Rabbit-Hole Trap**: While working on Task A, an obscure error or tempting refactor appears. The session spirals into micro-optimizations, the remaining plan is forgotten, and work stops prematurely with Tasks B and C abandoned.\n3. **The Invisible State Problem**: AI agents have internal memory and scratchpads, but these are opaque to the human developer in their IDE. The developer cannot see the plan, cannot adjust granularity or priority, and cannot tell if the agent has drifted off-course.\n\n`TODOLIST.md` solves all three problems:\n- **Atomic & Self-Contained**: Every task is broken down into small, unambiguous, independently verifiable units specifying exact target files, concrete changes, and verification commands.\n- **Shared & Accessible**: Lives right in the project root where the developer can inspect, edit, or reorder tasks in their own editor.\n- **Anchor Against Drift**: After every completed atomic step, the agent re-anchors itself to `TODOLIST.md` before picking the next task.\n- **Clean Ephemerality**: The file exists *only* while tasks are active. The moment all tasks are completed and verified, `TODOLIST.md` is automatically deleted, leaving zero clutter in the git tree.\n\n---\n\n## Atomicity & Detail Standard (Mandatory)\n\nNever write vague, coarse-grained tasks. Before writing `TODOLIST.md`, briefly inspect the relevant files so every task item carries concrete, actionable instructions.\n\n### The 4 Rules of Atomic Tasks\n1. **One Concern Per Item**: Each checkbox (`- [ ] **#1.1**`) must represent a single, cohesive change (e.g., one schema migration, one function\u002Fendpoint implementation, one component state wiring, or one test suite addition) that can be completed and verified in a single focused turn.\n2. **Explicit Target Locations**: Name the exact file path(s), function\u002Fclass symbols, or routes to create or modify (e.g., `src\u002Fauth\u002Fsession.ts -> revokeSession()`, not *\"in the auth module\"*).\n3. **Concrete Implementation Instructions**: State *what* must change and *how* — input\u002Foutput shapes, validation rules, error handling, edge cases, and invariants. Another engineer or fresh agent reading `TODOLIST.md` cold must be able to execute the item without guessing.\n4. **Executable Verification (\"Done When\")**: Every atomic task must specify how to prove it works (e.g., a specific test command, typecheck, CLI invocation, or expected response).\n\n### Bad (Vague) vs. Good (Atomic & Detailed)\n\n| Bad (Coarse & Ambiguous) | Good (Atomic, Detailed & Verifiable) |\n| :--- | :--- |\n| `- [ ] **#1** Add rate limiting to API` | `- [ ] **#1.1** Create sliding-window rate limiter middleware in \\`src\u002Fmiddleware\u002Frate-limit.ts\\` using Redis key \\`rl:{ip}:{route}\\`, limiting to 60 req\u002Fmin and returning HTTP 429 with \\`Retry-After\\` header.`\u003Cbr>`- [ ] **#1.2** Wire \\`rateLimitMiddleware\\` into public auth routes (\\`POST \u002Fapi\u002Fauth\u002Flogin\\`, \\`POST \u002Fapi\u002Fauth\u002Fregister\\`) in \\`src\u002Froutes\u002Fauth.ts\\`.`\u003Cbr>`- [ ] **#1.3** Add integration tests in \\`tests\u002Fmiddleware\u002Frate-limit.test.ts\\` covering under-limit (200), at-limit boundary, and over-limit (429 + header) cases.` |\n| `- [ ] **#2** Fix pagination bug` | `- [ ] **#2.1** Clamp \\`limit\\` parameter in \\`src\u002Forders\u002Frepository.ts -> listOrders()\\` to \\`Math.min(Math.max(1, limit ?? 20), 100)\\` and fix off-by-one cursor offset when \\`cursorId\\` is passed.`\u003Cbr>`- [ ] **#2.2** Add regression test in \\`tests\u002Forders\u002Frepository.test.ts\\` verifying \\`limit=0\\`, \\`limit=500\\`, and sequential cursor pages return non-overlapping items.` |\n\n---\n\n## The Lifecycle Contract\n\n```text\nUser states plans \u002F tasks\n          │\n          ▼\n   Quick reconnaissance (identify files & scope)\n          │\n          ▼\n   Decompose into atomic steps & create TODOLIST.md ◄──────┐\n          │                                                │\n          ▼                                                │\n   Execute Atomic Task #1.1                                │\n          │                                                │\n          ▼                                                │\n   Verify Task #1.1 & mark [x] in TODOLIST.md              │\n          │                                                │\n          ▼                                                │\n   Are all tasks [x] complete?                             │\n     ├── NO  ──► Focus on next pending atomic task         │\n     └── YES ──► Delete TODOLIST.md cleanly                │\n                         │                                 │\n                         ▼                                 │\n                  Clean Workspace                          │\n                         │                                 │\n                         └──── New tasks later? ───────────┘\n```\n\n### Core Rules\n1. **Always in Repository Root**: The file must be named `TODOLIST.md` and located in the workspace root.\n2. **Two-Way Synchronization**:\n   - The agent updates `TODOLIST.md` as tasks transition (`[ ]` pending -> `[\u002F]` in progress -> `[x]` done).\n   - If the user modifies `TODOLIST.md` in their editor, the agent respects the user's edits as the source of truth.\n3. **One Active Atomic Task at a Time**: Mark the currently active atomic item with `[\u002F]` and state it in the `Current Focus` section. Never multitask across multiple items simultaneously.\n4. **Verify Before Checking Off**: Never mark a task `[x]` until its `Verify` step has actually been executed and passed.\n5. **Auto-Deletion on Completion**: When the last remaining task is marked `[x]` and verified, the agent **must delete `TODOLIST.md`**.\n6. **Fresh Re-creation**: If new tasks are introduced in a subsequent session or turn, create a fresh `TODOLIST.md`.\n\n---\n\n## TODOLIST.md Template Format\n\nWhen creating `TODOLIST.md`, decompose the user's request into logical parent groups (`### #1 ...`) containing atomic, detailed sub-tasks (`- [ ] **#1.1** ...`):\n\n```markdown\n# Session To-Do List\n\n> **Goal**: [Clear 1-sentence summary of the session's objective and end state]  \n> **Status**: Active ([X]\u002F[Y] Atomic Tasks Completed)  \n> **Created**: YYYY-MM-DD  \n\n---\n\n## Tasks\n\n### #1 [Milestone \u002F Feature Area 1 Title]\n- [ ] **#1.1** **[Short Action Title]**\n  - **Files**: `path\u002Fto\u002Ffile.ts` (`symbolOrFunctionName`)\n  - **Action**: [Specific, unambiguous instructions: exact inputs\u002Foutputs, logic changes, validation rules, and edge cases to handle]\n  - **Verify**: [Exact command or check to prove completion, e.g., `npm test -- path\u002Fto\u002Ffile.test.ts`]\n- [ ] **#1.2** **[Short Action Title]**\n  - **Files**: `path\u002Fto\u002Fother.ts`, `tests\u002Fpath\u002Fto\u002Fother.test.ts`\n  - **Action**: [Specific implementation and test cases to add]\n  - **Verify**: [Exact verification command and expected outcome]\n\n### #2 [Milestone \u002F Feature Area 2 Title]\n- [ ] **#2.1** **[Short Action Title]**\n  - **Files**: `path\u002Fto\u002Fmodule.py`\n  - **Action**: [Specific instructions]\n  - **Verify**: [Exact verification command]\n\n---\n\n## Current Focus\n- **Active Task**: **#1.1** — [Short Action Title]\n- **Target Files**: `path\u002Fto\u002Ffile.ts`\n- **Done Criteria**: [What exact test or check proves this atomic step is finished]\n\n---\n\n## Completed\n*(Completed atomic tasks are logged here with verification evidence)*\n\n---\n\n\u003C!-- AUTOMATIC CLEANUP CONTRACT:\nThis file is temporary. When all atomic tasks above are checked [x], the agent will automatically delete TODOLIST.md.\n-->\n```\n\n---\n\n## Operational Commands\n\n### 1. Initialize or Intake (`\u002Ftodolist init` or `\u002Ftodolist \u003Ctasks>`)\n1. Read the user prompt for task descriptions, milestones, or plans.\n2. Perform a fast, read-only scan (`Glob`\u002F`Grep`\u002F`Read`) of the affected codebase areas so you can name real file paths, symbols, and test commands instead of placeholders.\n3. Decompose high-level requests into atomic sub-tasks (`#1.1`, `#1.2`, `#2.1`, ...) following the **Atomicity & Detail Standard**.\n4. Create `TODOLIST.md` at the repository root using the standard template.\n5. Output a concise summary confirming the atomic task count and immediately begin **#1.1** (or wait for confirmation if the user only asked to plan).\n\n### 2. Update Progress (`\u002Ftodolist progress` or inline execution)\nAs each atomic task is worked on and completed:\n1. Before starting an item, mark it `- [\u002F]` and set it under `## Current Focus`.\n2. Execute the code\u002Ftest changes described in `Action` and run the `Verify` check.\n3. Re-read `TODOLIST.md` to ensure no user edits are overwritten.\n4. Update the completed task checkbox from `- [\u002F]` to `- [x]`.\n5. Append a concise completion record under `## Completed` with verification proof (e.g., `- [x] **#1.1** Add sliding-window rate limiter — verified via vitest (4\u002F4 passing)`).\n6. Update `## Current Focus` to point to the next pending atomic item.\n7. Check if all items are complete.\n\n### 3. Check for Full Completion & Automatic Deletion\nWhen updating `TODOLIST.md`:\n1. Scan all checkboxes under `## Tasks`.\n2. If any unchecked `- [ ]` or in-progress `- [\u002F]` item remains: keep `TODOLIST.md`, inform the user of progress, and proceed to the next atomic item.\n3. If **100% of atomic tasks are marked `- [x]`**:\n   - Inform the user that all planned items are complete and verified.\n   - Delete `TODOLIST.md` (`rm TODOLIST.md` or file removal tool).\n   - Announce: `All todos completed and verified. TODOLIST.md has been removed.`\n\n### 4. Append or Split Tasks (`\u002Ftodolist add \u003Ctask>`)\n- If a new requirement emerges, decompose it into atomic steps (`Files`, `Action`, `Verify`) and append to `## Tasks`.\n- If an existing task turns out to be larger than expected during execution, **split it in place** into `#N.1`, `#N.2`, `#N.3` in `TODOLIST.md` before continuing, and update the total count in `Status`.\n\n### 5. Inspect \u002F Status (`\u002Ftodolist status`)\n1. Read `TODOLIST.md`.\n2. Report:\n   - Completed atomic tasks: `X\u002FY`\n   - Current active task and its verification target\n   - Next queued atomic tasks\n\n---\n\n## Agent Behavioral Discipline\n\n- **Decompose before executing**: If the user gives a broad goal (\"build feature X and fix bug Y\"), never copy-paste those two lines as two giant checkboxes. Break them down into 4–10 crisp, atomic steps with real file paths and verification commands first.\n- **Never ignore the list**: When you finish an atomic step, do not ask \"What should I do next?\" without checking `TODOLIST.md` first. Read `TODOLIST.md`, pick the next pending atomic item, mark it `[\u002F]`, and continue.\n- **Resist Scope Creep**: If you notice an unrelated bug or tempting cleanup during an atomic task:\n  - Do NOT derail the current atomic task.\n  - Either log it as a new pending atomic task at the end of `TODOLIST.md` (if in scope) or ask the user whether to add it.\n- **Preserve User Edits**: The user may open `TODOLIST.md` in their IDE to tweak instructions, reorder tasks, or add notes. Always read `TODOLIST.md` immediately before writing to merge state cleanly.\n",{"name":5,"description":7,"allowed-tools":24},"Bash Read Grep Glob Edit Write","main","42203fde5eb692ba254e058168ee1af75855fcb4","skills\u002Ftodolist",0,"https:\u002F\u002Fgithub.com\u002FMarvellbrazil\u002Fmy-agentic-skills","skills.marvellofaisal.me","https:\u002F\u002Fgithub.com\u002FMarvellbrazil","marvellofaisal.me","Software Engineering Student | Backend & API Developer | Tech Enthusiast | Homelabber","2026-10-23 22:23:52",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add Marvellbrazil\u002Fmy-agentic-skills --skill todolist",{"tool":41,"command":42},"bunx","bunx skills add Marvellbrazil\u002Fmy-agentic-skills --skill todolist",{"tool":44,"command":45},"pnpm","pnpm dlx skills add Marvellbrazil\u002Fmy-agentic-skills --skill todolist","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMarvellbrazil\u002Fmy-agentic-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftodolist\u002FSKILL.md",true,[],[50,57,64,71,78,85],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M7DDQP2F4E42AMTGY0VCJ6G2","writing-guidelines","Review docs\u002Fprose for Writing Guidelines compliance. Use when asked to \"review my docs\", \"check writing style\", \"audit prose\", \"review docs voice and tone\", or \"check this page against the writing handbook\".","https:\u002F\u002Fgithub.com\u002FMarvellbrazil\u002Fmy-agentic-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-guidelines\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7DDQM00XGSGT8V797C89R2E","writing-for-agents","Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002FMarvellbrazil\u002Fmy-agentic-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7DDQEF1HP9CMH88HMN9MCBA","wrangler","Cloudflare Workers CLI for deploying, developing, and managing Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines, and Secrets Store. Load before running wrangler commands to ensure correct syntax and best practices. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.","https:\u002F\u002Fgithub.com\u002FMarvellbrazil\u002Fmy-agentic-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwrangler\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7DDQA32ZAG7J4PMRXRSQ3NQ","workers-best-practices","Reviews and authors Cloudflare Workers code against production best practices. Load when writing new Workers, reviewing Worker code, configuring wrangler.jsonc, or checking for common Workers anti-patterns (streaming, floating promises, global state, secrets, bindings, observability). Biases towards retrieval from Cloudflare docs over pre-trained knowledge.","https:\u002F\u002Fgithub.com\u002FMarvellbrazil\u002Fmy-agentic-skills\u002Fblob\u002Fmain\u002Fskills\u002Fworkers-best-practices\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7DDQ5482QSC0FC4NX107FVY","web-perf","Analyzes web performance using Chrome DevTools MCP. Measures Core Web Vitals (LCP, INP, CLS) and supplementary metrics (FCP, TBT, Speed Index), identifies render-blocking resources, network dependency chains, layout shifts, caching issues, and accessibility gaps. Use when asked to audit, profile, debug, or optimize page load performance, Lighthouse scores, or site speed. Biases towards retrieval from current documentation over pre-trained knowledge.","https:\u002F\u002Fgithub.com\u002FMarvellbrazil\u002Fmy-agentic-skills\u002Fblob\u002Fmain\u002Fskills\u002Fweb-perf\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7DDQ1GZ7Z2Y67460SJJEMC0","using-agent-skills","Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all other skills are discovered and invoked.","https:\u002F\u002Fgithub.com\u002FMarvellbrazil\u002Fmy-agentic-skills\u002Fblob\u002Fmain\u002Fskills\u002Fusing-agent-skills\u002FSKILL.md",[],[]]