[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78C1PKQGS8XDM7AVK9WSQSJ":3,"skill-same:01M78C1PKQGS8XDM7AVK9WSQSJ":45},{"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":14,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M78C1PKQGS8XDM7AVK9WSQSJ","intent",null,"Captures a change request as a committed intent.md that a non-engineer can author, then promotes an accepted intent into a forge epic and tasks. Use when someone describes a problem or wish for the product (\"we need\", \"users keep\", \"it should\"), when a product owner wants to file work without the task CLI, or when an accepted intent is ready to enter the queue. NOT for vetting whether to build it (\u002Fvet-idea) or for project bootstrap (\u002Fnew-project).","rynhardt81\u002FforgeFlow","rynhardt81","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F52700299?v=4","01M78BZMY2RF5TVDY59XT67ZB6","RjvR","01M78BZMYQ2AJGBHKAT0M1Q2ZB",0,"MIT","https:\u002F\u002Fgithub.com\u002Frynhardt81\u002FforgeFlow\u002Fblob\u002Fmain\u002Fskills\u002Fintent\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: intent\ndescription: Captures a change request as a committed intent.md that a non-engineer can author, then promotes an accepted intent into a forge epic and tasks. Use when someone describes a problem or wish for the product (\"we need\", \"users keep\", \"it should\"), when a product owner wants to file work without the task CLI, or when an accepted intent is ready to enter the queue. NOT for vetting whether to build it (\u002Fvet-idea) or for project bootstrap (\u002Fnew-project).\nallowed-tools: Read, Glob, Grep, Bash, Write, Edit\n---\n\n# \u002Fintent\n\nTurns a conversation into a version-controlled intent, then turns an accepted intent into queue state. `\u002Fintent \"\u003Cproblem>\"` writes `intent\u002F\u003Cslug>.md`; `\u002Fintent promote intent\u002F\u003Cslug>.md [--epic E0X]` files an epic and tasks in the forge registry.\n\n## Index\n\n| File or section | Read when… |\n|---|---|\n| Capture | Writing a new intent from a described problem |\n| Promote | An intent has `Status: accepted` and is ready for the queue |\n| Where it sits | Choosing between `\u002Fvet-idea`, `\u002Fintent`, ISA, and `\u002Frun-epic` |\n| `_shared\u002Ftask-triage.md` | Derived work surfaces while promoting |\n\n## Artifact chain\n\nThe entry point to the artifact chain: **intent → PRD\u002FISA → tasks → PR**. The originator does not need the forge CLI, the Algorithm, or a task id. They need to describe a problem well enough that the next person can act on it. This skill gets them there and stops.\n\n## Capture: `\u002Fintent \"\u003Cproblem>\"`\n\n1. **Brainstorm until concrete.** Ask only what the template cannot be filled without: who feels this, what \"fixed\" looks like, what must not break. Three to five questions is normal. If the description already answers something, do not re-ask.\n2. **Write `intent\u002F\u003Cslug>.md`** from `templates\u002Fintent.md`. Slug is kebab-case from the title. Status `draft`, author from `git config user.name`, date today. Symptoms in Problem, checkable outcome in Proposed outcome, unknowns in Open questions — never invent answers to fill a section.\n3. **Show the file and let the author correct it.** Their words win over yours.\n4. **Commit it** as `intent: \u003Ctitle>` on the current branch. The commit is the audit trail: who asked, when, what was decided. Do not open a PR — acceptance is a status edit by the product owner, not a merge.\n\nDo not design the solution, estimate it, or file tasks here. That is what promote is for, and only after someone with authority has set `Status: accepted`.\n\n## Promote: `\u002Fintent promote intent\u002F\u003Cslug>.md [--epic E0X]`\n\nPreconditions: file exists, `Status: accepted`. Anything else — stop and say which precondition failed. A `draft` intent is not queue-eligible; a `rejected` one never is.\n\n**An intent is change-sized, not epic-sized.** On an existing product it is usually one to a few tasks inside an epic that already exists; only sometimes is it big enough to be its own epic. So the intent links to its **tasks**, and links to an epic only when it created that epic. A 35-task epic with one intent filed into it is not \"described by\" that intent, and the skill must never imply it is.\n\n1. **Read the intent and the project ISA** (`ISA.md`) if present, so tasks inherit the project's constraints.\n2. **Choose the epic.** With `--epic`, file into it (it must exist) and **leave its description alone** — the epic is where the work lives, not what the intent is about. Without `--epic`, the intent is its own epic; create one from the intent title and link it, because here the epic *is* the intent:\n\n   ```bash\n   python3 .claude\u002Fscripts\u002Fforge\u002Fforge.py epic add E0X --name \"\u003Cintent title>\" \\\n     --description \"From intent\u002F\u003Cslug>.md\"\n   ```\n\n3. **Draft tasks as tracer bullets** — the smallest sequence that reaches Proposed outcome. Look first for prefactoring that makes the work easier (\"make the change easy, then make the easy change\"); it goes first. Then slice:\n   - Each task cuts a narrow but COMPLETE path through every layer (schema, API, UI, tests): vertical, NOT a horizontal slice of one layer.\n   - A completed task is demoable or verifiable on its own.\n   - Each task is sized to fit in a single fresh context window.\n   - Each task declares its **blocking edges** — the tasks that must complete before it can start (`--deps`). A task with no blockers can start immediately.\n   - The exception is a **wide refactor** (one mechanical change that breaks many call sites at once): sequence it expand → migrate batches → contract, as `\u002Frefactor` defines.\n\n   Each task also names the files or directories it will touch (`--scope-dirs` \u002F `--scope-files`) and gets `--isa` when it is E3 or above. Open questions in the intent that block a task become `--deps` on a spike task that answers them, not silent assumptions.\n4. **Quiz the breakdown; confirm before filing.** Present it as a numbered list — per task: **Title**, **Blocked by**, **What it delivers** (the end-to-end behaviour it makes work) — and ask: does the granularity feel right (too coarse \u002F too fine)? Are the blocking edges correct — does each task only depend on tasks that genuinely gate it? Should any be merged or split? Iterate until approved; that approval is the one confirmation. Then file every task through the CLI in dependency order (blockers first, so `--deps` can name real ids). Never hand-edit `docs\u002Ftasks\u002Fregistry.json`.\n   After filing, append one line to each task body's `## Notes` section: `Intent: intent\u002F\u003Cslug>.md`. That line is how the intent travels — `\u002Frun-epic` reads it into the task's done-criterion and `\u002Fcreate-pr` checks the diff against it. The task body is the carrier because every downstream skill already reads it.\n5. **Mark the intent** `Status: promoted → T###, T### (E0X)` — the task ids are the link, the epic in parentheses is where to find them — and commit both changes together as `intent: promote \u003Cslug> → T###`. The intent stays in `intent\u002F` — it is what `\u002Fcreate-pr`'s reviewer and the task ISA are checked against. Tasks filed later for the same intent get appended to that line.\n\n## Where it sits\n\n| Question | Skill |\n|----------|-------|\n| Should we do this at all? | `\u002Fvet-idea` |\n| What does the requester want? | **`\u002Fintent`** (this) |\n| How will we know it is done? | ISA (`\u002Fnew-feature` scaffolds it at E3+) |\n| Do it | `\u002Frun-epic E0X` (drains the epic; each task carries its own intent link) |\n\nDerived work discovered while promoting follows `skills\u002F_shared\u002Ftask-triage.md` — an intent is not a licence to file everything it reminds you of.\n\n\u003C!-- Tracer-bullet slicing and the breakdown quiz adapted from mattpocock\u002Fskills to-tickets (MIT) — see THIRD-PARTY-NOTICES.md -->\n\n---\n\n**Project-specific overrides:** if `SKILL.local.md` exists in this directory, read it — it is consumer-owned, survives framework refresh, and **wins on conflict**. A sidecar that relaxes a gate defined above must state how to prove the gate is wrong in that case. Doctrine: `rules\u002Fframework-vs-project-root.md`.\n","# \u002Fintent\n\nTurns a conversation into a version-controlled intent, then turns an accepted intent into queue state. `\u002Fintent \"\u003Cproblem>\"` writes `intent\u002F\u003Cslug>.md`; `\u002Fintent promote intent\u002F\u003Cslug>.md [--epic E0X]` files an epic and tasks in the forge registry.\n\n## Index\n\n| File or section | Read when… |\n|---|---|\n| Capture | Writing a new intent from a described problem |\n| Promote | An intent has `Status: accepted` and is ready for the queue |\n| Where it sits | Choosing between `\u002Fvet-idea`, `\u002Fintent`, ISA, and `\u002Frun-epic` |\n| `_shared\u002Ftask-triage.md` | Derived work surfaces while promoting |\n\n## Artifact chain\n\nThe entry point to the artifact chain: **intent → PRD\u002FISA → tasks → PR**. The originator does not need the forge CLI, the Algorithm, or a task id. They need to describe a problem well enough that the next person can act on it. This skill gets them there and stops.\n\n## Capture: `\u002Fintent \"\u003Cproblem>\"`\n\n1. **Brainstorm until concrete.** Ask only what the template cannot be filled without: who feels this, what \"fixed\" looks like, what must not break. Three to five questions is normal. If the description already answers something, do not re-ask.\n2. **Write `intent\u002F\u003Cslug>.md`** from `templates\u002Fintent.md`. Slug is kebab-case from the title. Status `draft`, author from `git config user.name`, date today. Symptoms in Problem, checkable outcome in Proposed outcome, unknowns in Open questions — never invent answers to fill a section.\n3. **Show the file and let the author correct it.** Their words win over yours.\n4. **Commit it** as `intent: \u003Ctitle>` on the current branch. The commit is the audit trail: who asked, when, what was decided. Do not open a PR — acceptance is a status edit by the product owner, not a merge.\n\nDo not design the solution, estimate it, or file tasks here. That is what promote is for, and only after someone with authority has set `Status: accepted`.\n\n## Promote: `\u002Fintent promote intent\u002F\u003Cslug>.md [--epic E0X]`\n\nPreconditions: file exists, `Status: accepted`. Anything else — stop and say which precondition failed. A `draft` intent is not queue-eligible; a `rejected` one never is.\n\n**An intent is change-sized, not epic-sized.** On an existing product it is usually one to a few tasks inside an epic that already exists; only sometimes is it big enough to be its own epic. So the intent links to its **tasks**, and links to an epic only when it created that epic. A 35-task epic with one intent filed into it is not \"described by\" that intent, and the skill must never imply it is.\n\n1. **Read the intent and the project ISA** (`ISA.md`) if present, so tasks inherit the project's constraints.\n2. **Choose the epic.** With `--epic`, file into it (it must exist) and **leave its description alone** — the epic is where the work lives, not what the intent is about. Without `--epic`, the intent is its own epic; create one from the intent title and link it, because here the epic *is* the intent:\n\n   ```bash\n   python3 .claude\u002Fscripts\u002Fforge\u002Fforge.py epic add E0X --name \"\u003Cintent title>\" \\\n     --description \"From intent\u002F\u003Cslug>.md\"\n   ```\n\n3. **Draft tasks as tracer bullets** — the smallest sequence that reaches Proposed outcome. Look first for prefactoring that makes the work easier (\"make the change easy, then make the easy change\"); it goes first. Then slice:\n   - Each task cuts a narrow but COMPLETE path through every layer (schema, API, UI, tests): vertical, NOT a horizontal slice of one layer.\n   - A completed task is demoable or verifiable on its own.\n   - Each task is sized to fit in a single fresh context window.\n   - Each task declares its **blocking edges** — the tasks that must complete before it can start (`--deps`). A task with no blockers can start immediately.\n   - The exception is a **wide refactor** (one mechanical change that breaks many call sites at once): sequence it expand → migrate batches → contract, as `\u002Frefactor` defines.\n\n   Each task also names the files or directories it will touch (`--scope-dirs` \u002F `--scope-files`) and gets `--isa` when it is E3 or above. Open questions in the intent that block a task become `--deps` on a spike task that answers them, not silent assumptions.\n4. **Quiz the breakdown; confirm before filing.** Present it as a numbered list — per task: **Title**, **Blocked by**, **What it delivers** (the end-to-end behaviour it makes work) — and ask: does the granularity feel right (too coarse \u002F too fine)? Are the blocking edges correct — does each task only depend on tasks that genuinely gate it? Should any be merged or split? Iterate until approved; that approval is the one confirmation. Then file every task through the CLI in dependency order (blockers first, so `--deps` can name real ids). Never hand-edit `docs\u002Ftasks\u002Fregistry.json`.\n   After filing, append one line to each task body's `## Notes` section: `Intent: intent\u002F\u003Cslug>.md`. That line is how the intent travels — `\u002Frun-epic` reads it into the task's done-criterion and `\u002Fcreate-pr` checks the diff against it. The task body is the carrier because every downstream skill already reads it.\n5. **Mark the intent** `Status: promoted → T###, T### (E0X)` — the task ids are the link, the epic in parentheses is where to find them — and commit both changes together as `intent: promote \u003Cslug> → T###`. The intent stays in `intent\u002F` — it is what `\u002Fcreate-pr`'s reviewer and the task ISA are checked against. Tasks filed later for the same intent get appended to that line.\n\n## Where it sits\n\n| Question | Skill |\n|----------|-------|\n| Should we do this at all? | `\u002Fvet-idea` |\n| What does the requester want? | **`\u002Fintent`** (this) |\n| How will we know it is done? | ISA (`\u002Fnew-feature` scaffolds it at E3+) |\n| Do it | `\u002Frun-epic E0X` (drains the epic; each task carries its own intent link) |\n\nDerived work discovered while promoting follows `skills\u002F_shared\u002Ftask-triage.md` — an intent is not a licence to file everything it reminds you of.\n\n\u003C!-- Tracer-bullet slicing and the breakdown quiz adapted from mattpocock\u002Fskills to-tickets (MIT) — see THIRD-PARTY-NOTICES.md -->\n\n---\n\n**Project-specific overrides:** if `SKILL.local.md` exists in this directory, read it — it is consumer-owned, survives framework refresh, and **wins on conflict**. A sidecar that relaxes a gate defined above must state how to prove the gate is wrong in that case. Doctrine: `rules\u002Fframework-vs-project-root.md`.\n",{"name":5,"description":7,"allowed-tools":24},"Read, Glob, Grep, Bash, Write, Edit","main","51a4b0dd2ff140f5a7ccf57daaa79defe2489745","skills\u002Fintent","https:\u002F\u002Fgithub.com\u002Frynhardt81\u002FforgeFlow","https:\u002F\u002Fgithub.com\u002Frynhardt81","2026-10-23 13:56:45",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add rynhardt81\u002FforgeFlow --skill intent",{"tool":37,"command":38},"bunx","bunx skills add rynhardt81\u002FforgeFlow --skill intent",{"tool":40,"command":41},"pnpm","pnpm dlx skills add rynhardt81\u002FforgeFlow --skill intent","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frynhardt81\u002FforgeFlow\u002Fblob\u002Fmain\u002Fskills\u002Fintent\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M78C3X48Y2TPS649BRYJZWT3","wizard","Generates an interactive bash wizard that walks a human through steps only they can perform — opens each URL, says what to click and copy, captures values (hidden entry for secrets), writes .env and GitHub secrets, confirms before irreversible actions. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.","https:\u002F\u002Fgithub.com\u002Frynhardt81\u002FforgeFlow\u002Fblob\u002Fmain\u002Fskills\u002Fwizard\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M78C3RJ1F82TBBK398FR824Q","vet-idea","Vets an idea, decision, or plan BEFORE it is built. Runs a single model through five fixed adversarial advisor roles, a peer-review pass, and a chairman synthesis that emits a halt-capable GO \u002F NO-GO \u002F RECONSIDER verdict. Advisory and non-mutating — outputs a report, never writes task state. Use when an idea, feature, or costly hard-to-reverse decision is of uncertain worth and the question is whether to build it at all. NOT FOR settled work (bug fixes, approved features) or for shaping how to build it (the ISA Interview workflow).","https:\u002F\u002Fgithub.com\u002Frynhardt81\u002FforgeFlow\u002Fblob\u002Fmain\u002Fskills\u002Fvet-idea\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M78C3JXH3ABXMDK2ZESXYM3R","triage-incident","Production incident triage — from \"something is broken for users\" to fixed, verified, and learned-from. Pulls the error signal (Sentry\u002Flogs\u002Fuser report), reproduces before touching code, routes the fix through \u002Ffix-bug's prod fast path, and closes with a postmortem entry. Use when something is broken for users in production — an outage, data corruption, a Sentry spike, or a crash-rate alert. NOT FOR bugs found in development (use \u002Ffix-bug directly) or CI failures (use \u002Fdiagnose-ci).","https:\u002F\u002Fgithub.com\u002Frynhardt81\u002FforgeFlow\u002Fblob\u002Fmain\u002Fskills\u002Ftriage-incident\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M78C3F8RA1PSYSV5KR6FYYDW","setup-review-bot","Configures a repo's AI code reviewers — the post-PR mention bot and the pre-push local reviewer — and writes the AGENTS.md the reviewers read. Interviews the user for what the reviewer should weight, then sets git config forge.reviewBot \u002F forge.localReview and populates AGENTS.md at the project root. Use when a repo has no reviewer configured, when review findings are consistently off-target, or when onboarding a new project.","https:\u002F\u002Fgithub.com\u002Frynhardt81\u002FforgeFlow\u002Fblob\u002Fmain\u002Fskills\u002Fsetup-review-bot\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M78C3AFB8Y33VNN47DAB0QKJ","security-review","Portable security review for a feature, endpoint, or change before it ships. Orchestrates the existing OWASP review (@security-boss) and secrets scan (security_secrets validator), then adds the pass they miss — an explicit business-logic-flaw walkthrough (IDOR, race\u002FTOCTOU, state-machine bypass, privilege escalation, price\u002Fquantity tampering). Advisory and non-mutating — produces a findings report; real findings are filed as tasks. Use when a change touching money, access control, or multi-step state is about to ship, or when the auth looks fine but the flow could be abused. NOT FOR SAST or dependency-CVE scanning (consumer CI owns those).","https:\u002F\u002Fgithub.com\u002Frynhardt81\u002FforgeFlow\u002Fblob\u002Fmain\u002Fskills\u002Fsecurity-review\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M78C36APGXG6WFF3DFEPPQMZ","run-epic","Autonomously drains every open task in a single epic. Pulls ready tasks via the forge CLI, executes the work in-context using the matching discipline (fix-bug \u002F new-feature \u002F refactor), files newly-discovered work as follow-up tasks without stopping to ask, opens a PR per completed task via \u002Fcreate-pr, and repeats until the epic has zero ready\u002Fin-progress\u002Fpending tasks. Use when the user says `\u002Frun-epic E##`, \"run epic autonomously\", \"finish all remaining tasks for epic X\", or \"drive epic X to completion\".","https:\u002F\u002Fgithub.com\u002Frynhardt81\u002FforgeFlow\u002Fblob\u002Fmain\u002Fskills\u002Frun-epic\u002FSKILL.md",[],[]]