docs: restructure skill catalog and standardize setup-skills references
Reorganize README.md with category sections (engineering, pkm, etc.) for both user-invoked and model-invoked skills. Add new subcategory READMEs for skill-authoring and thinking-and-docs. Replace /setup-matt-pocock-skills references with setup-skills across all SKILLs.
This commit is contained in:
@@ -1,23 +1,102 @@
|
||||
# Skills
|
||||
|
||||
Agent skills (slash commands and behaviors) loaded into my agent.
|
||||
Agent skills (slash commands and behaviors) loaded into AI coding agents.
|
||||
|
||||
Skills are grouped by invocation type. [User-invoked](docs/invocation.md) skills run only when a person invokes them; model-invoked skills can also be selected automatically.
|
||||
|
||||
## User-invoked
|
||||
|
||||
- [agent-handoff](common/in-progress/agent-handoff/SKILL.md) — Hand the current conversation off to a fresh background agent that picks up the work immediately.
|
||||
- [commit-staged](common/engineering/commit-staged/SKILL.md) — Commit staged files with a conventional commit message.
|
||||
- [conversation-summary](common/pkm/conversation-summary/SKILL.md) — Save the current conversation as a comprehensive report note in your Obsidian vault, following OKF v0.1 conventions.
|
||||
- [crit](common/pkm/crit/SKILL.md) — Run the CRIT framework — give the AI Context, assign it a Role, let it Interview you one question at a time, then issue the Task.
|
||||
- [implement-isolation](common/engineering/implement-isolation/SKILL.md) — Implement a piece of work based on a spec or set of tickets in isolation.
|
||||
- [implement-isolation-tmux](common/engineering/implement-isolation-tmux/SKILL.md) — Dispatch a child agent in an isolated git worktree to implement a piece of work based on a PRD or set of issues.
|
||||
- [knowledge-gardener](common/in-progress/knowledge-gardener/SKILL.md) — Run vault-aware semantic search, synthesis, note creation, linking, and Zettelkasten workflows for this Obsidian vault.
|
||||
- [project-context-pack](common/engineering/project-context-pack/SKILL.md) — Build a bounded repo context pack (project map, codebase index, cached memory file) so later work uses fd/rg/tree-sitter/LSP instead of repeated browsing.
|
||||
- [research-vault](common/pkm/research-vault/SKILL.md) — Research a topic through a one-question-at-a-time learning conversation, answer directly, share resources when useful, and save a linked OKF-conformant research packet in the Obsidian vault.
|
||||
- [setup-skills](common/engineering/setup-skills/SKILL.md) — Configure this repo for the engineering skills, set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.
|
||||
- [tmux-launch-agent](common/misc/tmux-launch-agent/SKILL.md) — Fork a new agent CLI session into a new tmux window, detected from the current agent.
|
||||
- [youtube-video-capture](common/pkm/youtube-video-capture/SKILL.md) — Fetch subtitles from a YouTube video, summarize the content, and save both the summary and raw subtitles to the Video bundle in the Obsidian vault.
|
||||
### Engineering
|
||||
|
||||
- [commit-staged](skills/engineering/commit-staged/SKILL.md) — Commit staged files with a conventional commit message.
|
||||
- [grill-with-docs](skills/engineering/grill-with-docs/SKILL.md) — Interview the user to sharpen a plan or design while creating ADRs and glossary docs.
|
||||
- [implement](skills/engineering/implement/SKILL.md) — Implement a piece of work from a spec or set of tickets.
|
||||
- [implement-isolation](skills/engineering/implement-isolation/SKILL.md) — Implement a piece of work from a spec or set of tickets in isolation.
|
||||
- [implement-isolation-tmux](skills/engineering/implement-isolation-tmux/SKILL.md) — Dispatch an isolated worktree agent to implement work from a PRD or issues.
|
||||
- [improve-codebase-architecture](skills/engineering/improve-codebase-architecture/SKILL.md) — Find and work through opportunities to deepen a codebase's architecture.
|
||||
- [project-context-pack](skills/engineering/project-context-pack/SKILL.md) — Build a bounded project context pack for later agent work.
|
||||
- [setup-skills](skills/setup-skills/SKILL.md) — Configure engineering skills, issue tracking, triage labels, and domain docs.
|
||||
- [to-spec](skills/engineering/to-spec/SKILL.md) — Turn the current conversation into a spec and publish it to the issue tracker.
|
||||
- [to-tickets](skills/engineering/to-tickets/SKILL.md) — Break a plan or spec into tracer-bullet tickets with dependencies.
|
||||
- [triage](skills/engineering/triage/SKILL.md) — Triage issues and external PRs through the project workflow.
|
||||
- [wayfinder](skills/engineering/wayfinder/SKILL.md) — Plan large work as decision tickets and resolve them step by step.
|
||||
|
||||
### In-progress
|
||||
|
||||
- [agent-handoff](skills/in-progress/agent-handoff/SKILL.md) — Hand the current conversation to a fresh background agent.
|
||||
- [knowledge-gardener](skills/in-progress/knowledge-gardener/SKILL.md) — Run vault-aware search, synthesis, note creation, and linking workflows.
|
||||
|
||||
### Miscellaneous
|
||||
|
||||
- [bro](skills/misc/bro/SKILL.md) — Restate the last message in plain human language.
|
||||
- [tmux-launch-agent](skills/misc/tmux-launch-agent/SKILL.md) — Fork a new agent CLI session into a new tmux window.
|
||||
|
||||
### PKM
|
||||
|
||||
- [conversation-summary](skills/pkm/conversation-summary/SKILL.md) — Save the current conversation as a report note in an Obsidian vault.
|
||||
- [crit](skills/pkm/crit/SKILL.md) — Run the CRIT framework through context, role, interview, and task.
|
||||
- [research-vault](skills/pkm/research-vault/SKILL.md) — Research a topic through a guided conversation and save a linked vault packet.
|
||||
- [youtube-video-capture](skills/pkm/youtube-video-capture/SKILL.md) — Capture a YouTube video's subtitles and summary in an Obsidian vault.
|
||||
|
||||
### Productivity
|
||||
|
||||
- [grill-me](skills/productivity/grill-me/SKILL.md) — Interview the user to sharpen a plan or design.
|
||||
- [handoff](skills/productivity/handoff/SKILL.md) — Compact the current conversation into a handoff document.
|
||||
- [teach](skills/productivity/teach/SKILL.md) — Teach the user a new skill or concept within the workspace.
|
||||
- [to-questionnaire](skills/productivity/to-questionnaire/SKILL.md) — Turn an unresolved decision into a questionnaire.
|
||||
- [wait-what](skills/productivity/wait-what/SKILL.md) — Re-pitch the last message in clearer terms.
|
||||
|
||||
### Skill authoring
|
||||
|
||||
No user-invoked skills.
|
||||
|
||||
### Thinking and docs
|
||||
|
||||
- [before-building](skills/thinking-and-docs/before-building/SKILL.md) — Surface consequential choices when the user proposes a build.
|
||||
- [decisions](skills/thinking-and-docs/decisions/SKILL.md) — List choices made during the current work that remain uncertain.
|
||||
- [level-up](skills/thinking-and-docs/level-up/SKILL.md) — Assess technical and product knowledge and grow a learning plan.
|
||||
- [read-all-adrs](skills/thinking-and-docs/read-all-adrs/SKILL.md) — Read every ADR in the project's `docs/adr/` folder.
|
||||
- [remind](skills/thinking-and-docs/remind/SKILL.md) — Rewrite the last response more simply and briefly.
|
||||
- [short](skills/thinking-and-docs/short/SKILL.md) — Compress the current answer while keeping its substance.
|
||||
- [teach](skills/thinking-and-docs/teach/SKILL.md) — Teach the user a new skill or concept within the workspace.
|
||||
|
||||
## Model-invoked
|
||||
|
||||
- [lsp-code-analysis](common/engineering/lsp-code-analysis/SKILL.md) — Semantic code analysis via LSP. Navigate code (definitions, references, implementations), search symbols, preview refactorings, and get file outlines. Use for exploring unfamiliar codebases or performing safe refactoring.
|
||||
- [pkm-curation](common/pkm/pkm-curation/SKILL.md) — Curate an Obsidian vault — classify notes, normalize frontmatter, add links, extract atomic notes. Use when curating, batch-processing, reviewing, or doing a serendipity pick.
|
||||
### Engineering
|
||||
|
||||
- [code-review](skills/engineering/code-review/SKILL.md) — Review changes against repository standards and the originating specification.
|
||||
- [codebase-design](skills/engineering/codebase-design/SKILL.md) — Design and improve deep module interfaces and seams.
|
||||
- [diagnosing-bugs](skills/engineering/diagnosing-bugs/SKILL.md) — Diagnose hard bugs and performance regressions.
|
||||
- [domain-modeling](skills/engineering/domain-modeling/SKILL.md) — Build and sharpen a project's domain model.
|
||||
- [lsp-code-analysis](skills/engineering/lsp-code-analysis/SKILL.md) — Navigate code and analyze it semantically with LSP.
|
||||
- [prototype](skills/engineering/prototype/SKILL.md) — Build a throwaway prototype to answer a design question.
|
||||
- [research](skills/engineering/research/SKILL.md) — Investigate a question using high-trust sources and capture the findings.
|
||||
- [resolving-merge-conflicts](skills/engineering/resolving-merge-conflicts/SKILL.md) — Resolve an in-progress Git merge or rebase conflict.
|
||||
- [tdd](skills/engineering/tdd/SKILL.md) — Use test-driven development for features, bugs, and integration tests.
|
||||
- [wizard](skills/engineering/wizard/SKILL.md) — Generate an interactive wizard for steps only a human can perform.
|
||||
|
||||
### Miscellaneous
|
||||
|
||||
- [migrate-to-shoehorn](skills/misc/migrate-to-shoehorn/SKILL.md) — Migrate test assertions from `as` to `@total-typescript/shoehorn`.
|
||||
- [scaffold-exercises](skills/misc/scaffold-exercises/SKILL.md) — Create linted exercise directories with problems, solutions, and explainers.
|
||||
- [setup-pre-commit](skills/misc/setup-pre-commit/SKILL.md) — Set up Husky, lint-staged, type checking, and tests.
|
||||
|
||||
### PKM
|
||||
|
||||
- [pkm-curation](skills/pkm/pkm-curation/SKILL.md) — Curate an Obsidian vault with classification, links, and atomic notes.
|
||||
|
||||
### Productivity
|
||||
|
||||
- [grilling](skills/productivity/grilling/SKILL.md) — Grill the user relentlessly about a plan or design.
|
||||
- [writing-for-agents](skills/productivity/writing-for-agents/SKILL.md) — Write effective documents for agents.
|
||||
|
||||
### Skill authoring
|
||||
|
||||
- [effective-agent-skills](skills/skill-authoring/effective-agent-skills/SKILL.md) — Write, review, and debug effective agent skills.
|
||||
|
||||
### Thinking and docs
|
||||
|
||||
- [brain-to-docs](skills/thinking-and-docs/brain-to-docs/SKILL.md) — Extract project vision, decisions, and preferences into documentation.
|
||||
- [next-decision](skills/thinking-and-docs/next-decision/SKILL.md) — Drill into the next unresolved decision with choices and a recommendation.
|
||||
- [prompt-me](skills/thinking-and-docs/prompt-me/SKILL.md) — Ask pointed questions to extract project priorities and concerns.
|
||||
- [save-idea](skills/thinking-and-docs/save-idea/SKILL.md) — Capture content ideas in the user's content backlog.
|
||||
|
||||
@@ -5,11 +5,27 @@ Daily code work.
|
||||
## User-invoked
|
||||
|
||||
- [commit-staged](commit-staged/SKILL.md) — Commit staged files with a conventional commit message.
|
||||
- [implement-isolation](implement-isolation/SKILL.md) — Implement a piece of work based on a spec or set of tickets in isolation.
|
||||
- [implement-isolation-tmux](implement-isolation-tmux/SKILL.md) — Dispatch a child agent in an isolated git worktree to implement a piece of work based on a PRD or set of issues.
|
||||
- [project-context-pack](project-context-pack/SKILL.md) — Build a bounded repo context pack (project map, codebase index, cached memory file) so later work uses fd/rg/tree-sitter/LSP instead of repeated browsing.
|
||||
- [setup-skills](setup-skills/SKILL.md) — Configure this repo for the engineering skills, set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.
|
||||
- [grill-with-docs](grill-with-docs/SKILL.md) — Interview the user to sharpen a plan or design while creating ADRs and glossary docs.
|
||||
- [implement](implement/SKILL.md) — Implement a piece of work from a spec or set of tickets.
|
||||
- [implement-isolation](implement-isolation/SKILL.md) — Implement a piece of work from a spec or set of tickets in isolation.
|
||||
- [implement-isolation-tmux](implement-isolation-tmux/SKILL.md) — Dispatch an isolated worktree agent to implement work from a PRD or issues.
|
||||
- [improve-codebase-architecture](improve-codebase-architecture/SKILL.md) — Find and work through opportunities to deepen a codebase's architecture.
|
||||
- [project-context-pack](project-context-pack/SKILL.md) — Build a bounded project context pack for later agent work.
|
||||
- [setup-skills](../setup-skills/SKILL.md) — Configure engineering skills, issue tracking, triage labels, and domain docs.
|
||||
- [to-spec](to-spec/SKILL.md) — Turn the current conversation into a spec and publish it to the issue tracker.
|
||||
- [to-tickets](to-tickets/SKILL.md) — Break a plan or spec into tracer-bullet tickets with dependencies.
|
||||
- [triage](triage/SKILL.md) — Triage issues and external PRs through the project workflow.
|
||||
- [wayfinder](wayfinder/SKILL.md) — Plan large work as decision tickets and resolve them step by step.
|
||||
|
||||
## Model-invoked
|
||||
|
||||
- [lsp-code-analysis](lsp-code-analysis/SKILL.md) — Semantic code analysis via LSP. Navigate code (definitions, references, implementations), search symbols, preview refactorings, and get file outlines. Use for exploring unfamiliar codebases or performing safe refactoring.
|
||||
- [code-review](code-review/SKILL.md) — Review changes against repository standards and the originating specification.
|
||||
- [codebase-design](codebase-design/SKILL.md) — Design and improve deep module interfaces and seams.
|
||||
- [diagnosing-bugs](diagnosing-bugs/SKILL.md) — Diagnose hard bugs and performance regressions.
|
||||
- [domain-modeling](domain-modeling/SKILL.md) — Build and sharpen a project's domain model.
|
||||
- [lsp-code-analysis](lsp-code-analysis/SKILL.md) — Navigate code and analyze it semantically with LSP.
|
||||
- [prototype](prototype/SKILL.md) — Build a throwaway prototype to answer a design question.
|
||||
- [research](research/SKILL.md) — Investigate a question using high-trust sources and capture the findings.
|
||||
- [resolving-merge-conflicts](resolving-merge-conflicts/SKILL.md) — Resolve an in-progress Git merge or rebase conflict.
|
||||
- [tdd](tdd/SKILL.md) — Use test-driven development for features, bugs, and integration tests.
|
||||
- [wizard](wizard/SKILL.md) — Generate an interactive wizard for steps only a human can perform.
|
||||
|
||||
@@ -10,7 +10,7 @@ Two-axis review of the diff between `HEAD` and a fixed point the user supplies:
|
||||
|
||||
Both axes run as **parallel sub-agents** so they don't pollute each other's context, then this skill aggregates their findings.
|
||||
|
||||
The issue tracker should have been provided to you. If `docs/agents/issue-tracker.md` is missing, tell the user to run `/setup-matt-pocock-skills`.
|
||||
The issue tracker should have been provided to you. If `docs/agents/issue-tracker.md` is missing, tell the user to run `setup-skills`.
|
||||
|
||||
## Process
|
||||
|
||||
|
||||
@@ -6,7 +6,7 @@ disable-model-invocation: true
|
||||
|
||||
This skill takes the current conversation context and codebase understanding and produces a spec. Do NOT interview the user; just synthesize what you already know.
|
||||
|
||||
The issue tracker and triage label vocabulary should have been provided to you. If not, tell the user to run `/setup-matt-pocock-skills`.
|
||||
The issue tracker and triage label vocabulary should have been provided to you. If not, tell the user to run `setup-skills` skill.
|
||||
|
||||
## Process
|
||||
|
||||
|
||||
@@ -8,7 +8,7 @@ disable-model-invocation: true
|
||||
|
||||
Break a plan, spec, or conversation into a set of **tickets**: tracer-bullet vertical slices, each declaring the tickets that **block** it.
|
||||
|
||||
The issue tracker and triage label vocabulary should have been provided to you. If not, tell the user to run `/setup-matt-pocock-skills`.
|
||||
The issue tracker and triage label vocabulary should have been provided to you. If not, tell the user to run `setup-skills` skill.
|
||||
|
||||
## Process
|
||||
|
||||
@@ -57,7 +57,7 @@ Iterate until the user approves the breakdown.
|
||||
|
||||
### 5. Publish the tickets to the configured tracker
|
||||
|
||||
Publish the approved tickets. **How** depends on the tracker `/setup-matt-pocock-skills` configured; the tickets are the same either way, only the shape of the blocking edges changes:
|
||||
Publish the approved tickets. **How** depends on the tracker `setup-skills` skill configured; the tickets are the same either way, only the shape of the blocking edges changes:
|
||||
|
||||
- **Local files** → write one file per ticket under `.scratch/<feature-slug>/issues/<NN>-<slug>.md`, numbered from `01` in dependency order (blockers first). Each file's "Blocked by" lists the numbers/titles it depends on. Use the per-ticket file template below: one ticket per file, never a single combined file.
|
||||
- **A real issue tracker (GitHub, Linear, …)** → publish one issue per ticket in dependency order (blockers first) so each ticket's blocking edges can reference real identifiers. Use the platform's native blocking / sub-issue relationship where it has one; otherwise set each ticket's "Blocked by" to the blocking issues. Apply the `ready-for-agent` triage label unless instructed otherwise; the tickets are agent-grabbable by construction.
|
||||
|
||||
@@ -40,7 +40,7 @@ For a PR, the same states read against the attached code: `ready-for-agent` mean
|
||||
|
||||
Every triaged issue should carry exactly one category role and one state role. If state roles conflict, flag it and ask the maintainer before doing anything else.
|
||||
|
||||
These are canonical role names. The actual label strings used in the issue tracker may differ. The mapping should have been provided to you. If not, tell the user to run `/setup-matt-pocock-skills`.
|
||||
These are canonical role names. The actual label strings used in the issue tracker may differ. The mapping should have been provided to you. If not, tell the user to run `setup-skills` skill.
|
||||
|
||||
State transitions: an unlabeled issue normally goes to `needs-triage` first; from there it moves to `needs-info`, `ready-for-agent`, `ready-for-human`, or `wontfix`. `needs-info` returns to `needs-triage` once the reporter replies. The maintainer can override at any time; flag transitions that look unusual and ask before proceeding.
|
||||
|
||||
|
||||
@@ -22,7 +22,7 @@ The map is a single issue on this repo's issue tracker, labelled `wayfinder:map`
|
||||
|
||||
The map is an **index**, not a store. It lists the decisions made and points at the tickets that hold their detail; a decision lives in exactly one place, its ticket, so the map never restates it, only gists it and links.
|
||||
|
||||
**Where the map, its child tickets, blocking, and frontier queries physically live is tracker-specific.** The issue tracker should have been provided to you. If not, tell the user to run `/setup-matt-pocock-skills`. Consult the tracker doc's "Wayfinding operations" section for how _this_ repo expresses them. If no tracker has been provided, default to the local-markdown tracker.
|
||||
**Where the map, its child tickets, blocking, and frontier queries physically live is tracker-specific.** The issue tracker should have been provided to you. If not, tell the user to run `setup-skills` skill. Consult the tracker doc's "Wayfinding operations" section for how _this_ repo expresses them. If no tracker has been provided, default to the local-markdown tracker.
|
||||
|
||||
### The map body
|
||||
|
||||
|
||||
@@ -4,5 +4,9 @@ Drafts not yet ready to ship.
|
||||
|
||||
## User-invoked
|
||||
|
||||
- [agent-handoff](agent-handoff/SKILL.md) — Hand the current conversation off to a fresh background agent that picks up the work immediately.
|
||||
- [knowledge-gardener](knowledge-gardener/SKILL.md) — Run vault-aware semantic search, synthesis, note creation, linking, and Zettelkasten workflows for this Obsidian vault.
|
||||
- [agent-handoff](agent-handoff/SKILL.md) — Hand the current conversation to a fresh background agent.
|
||||
- [knowledge-gardener](knowledge-gardener/SKILL.md) — Run vault-aware search, synthesis, note creation, and linking workflows.
|
||||
|
||||
## Model-invoked
|
||||
|
||||
No model-invoked skills.
|
||||
|
||||
@@ -1,7 +1,14 @@
|
||||
# Misc Skills
|
||||
# Miscellaneous Skills
|
||||
|
||||
Kept around but rarely used.
|
||||
|
||||
## User-invoked
|
||||
|
||||
- [tmux-launch-agent](tmux-launch-agent/SKILL.md) — Fork a new agent CLI session into a new tmux window, detected from the current agent.
|
||||
- [bro](bro/SKILL.md) — Restate the last message in plain human language.
|
||||
- [tmux-launch-agent](tmux-launch-agent/SKILL.md) — Fork a new agent CLI session into a new tmux window.
|
||||
|
||||
## Model-invoked
|
||||
|
||||
- [migrate-to-shoehorn](migrate-to-shoehorn/SKILL.md) — Migrate test assertions from `as` to `@total-typescript/shoehorn`.
|
||||
- [scaffold-exercises](scaffold-exercises/SKILL.md) — Create linted exercise directories with problems, solutions, and explainers.
|
||||
- [setup-pre-commit](setup-pre-commit/SKILL.md) — Set up Husky, lint-staged, type checking, and tests.
|
||||
|
||||
@@ -4,11 +4,11 @@ Personal knowledge management.
|
||||
|
||||
## User-invoked
|
||||
|
||||
- [conversation-summary](conversation-summary/SKILL.md) — Save the current conversation as a comprehensive report note in your Obsidian vault, following OKF v0.1 conventions.
|
||||
- [crit](crit/SKILL.md) — Run the CRIT framework — give the AI Context, assign it a Role, let it Interview you one question at a time, then issue the Task.
|
||||
- [research-vault](research-vault/SKILL.md) — Research a topic through a one-question-at-a-time learning conversation, answer directly, share resources when useful, and save a linked OKF-conformant research packet in the Obsidian vault.
|
||||
- [youtube-video-capture](youtube-video-capture/SKILL.md) — Fetch subtitles from a YouTube video, summarize the content, and save both the summary and raw subtitles to the Video bundle in the Obsidian vault.
|
||||
- [conversation-summary](conversation-summary/SKILL.md) — Save the current conversation as a report note in an Obsidian vault.
|
||||
- [crit](crit/SKILL.md) — Run the CRIT framework through context, role, interview, and task.
|
||||
- [research-vault](research-vault/SKILL.md) — Research a topic through a guided conversation and save a linked vault packet.
|
||||
- [youtube-video-capture](youtube-video-capture/SKILL.md) — Capture a YouTube video's subtitles and summary in an Obsidian vault.
|
||||
|
||||
## Model-invoked
|
||||
|
||||
- [pkm-curation](pkm-curation/SKILL.md) — Curate an Obsidian vault — classify notes, normalize frontmatter, add links, extract atomic notes. Use when curating, batch-processing, reviewing, or doing a serendipity pick.
|
||||
- [pkm-curation](pkm-curation/SKILL.md) — Curate an Obsidian vault with classification, links, and atomic notes.
|
||||
|
||||
@@ -1,20 +1,16 @@
|
||||
# Productivity
|
||||
# Productivity Skills
|
||||
|
||||
General workflow tools, not code-specific.
|
||||
|
||||
## User-invoked
|
||||
|
||||
Reachable only when you type them (Claude Code: `disable-model-invocation: true`; Codex: `policy.allow_implicit_invocation: false` in `agents/openai.yaml`).
|
||||
|
||||
- **[grill-me](./grill-me/SKILL.md)**: Get relentlessly interviewed about a plan or design until every branch of the design tree is resolved.
|
||||
- **[handoff](./handoff/SKILL.md)**: Compact the current conversation into a handoff document so another agent can continue the work.
|
||||
- **[teach](./teach/SKILL.md)**: Teach the user a new skill or concept over multiple sessions, using the current directory as a stateful teaching workspace.
|
||||
- **[to-questionnaire](./to-questionnaire/SKILL.md)**: Turn a decision you can't answer alone into a Markdown questionnaire for the one person who can (filled in async, or together over a meeting).
|
||||
- **[wait-what](./wait-what/SKILL.md)**: Fire this the moment a message doesn't land. The agent re-pitches it with the context you're missing, in plain English, using your `CONTEXT.md` vocabulary.
|
||||
- [grill-me](grill-me/SKILL.md) — Interview the user to sharpen a plan or design.
|
||||
- [handoff](handoff/SKILL.md) — Compact the current conversation into a handoff document.
|
||||
- [teach](teach/SKILL.md) — Teach the user a new skill or concept within the workspace.
|
||||
- [to-questionnaire](to-questionnaire/SKILL.md) — Turn an unresolved decision into a questionnaire.
|
||||
- [wait-what](wait-what/SKILL.md) — Re-pitch the last message in clearer terms.
|
||||
|
||||
## Model-invoked
|
||||
|
||||
Model- or user-reachable (rich trigger phrasing so the model can reach for them).
|
||||
|
||||
- **[grilling](./grilling/SKILL.md)**: Interview the user relentlessly about a plan, decision, or idea until every branch of the design tree is resolved.
|
||||
- **[writing-for-agents](./writing-for-agents/SKILL.md)**: Writing documents for agents: skills, AGENTS.md/CLAUDE.md, and any doc an agent reaches by a pointer.
|
||||
- [grilling](grilling/SKILL.md) — Grill the user relentlessly about a plan or design.
|
||||
- [writing-for-agents](writing-for-agents/SKILL.md) — Write effective documents for agents.
|
||||
|
||||
@@ -8,11 +8,11 @@ Architecture Decision Records live on the forge wiki and are cloned into `docs/a
|
||||
<wiki-url>
|
||||
```
|
||||
|
||||
Derived from the forge remote during `/setup-skills`.
|
||||
Derived from the forge remote during `setup-skills`.
|
||||
|
||||
## Bootstrap
|
||||
|
||||
On first setup, `/setup-skills` clones the wiki:
|
||||
On first setup, `setup-skills` clones the wiki:
|
||||
|
||||
```bash
|
||||
git clone <wiki-url> docs/adr/
|
||||
|
||||
@@ -43,7 +43,7 @@ Multi-context repo (presence of `CONTEXT-MAP.md` at the root):
|
||||
|
||||
## ADR lifecycle
|
||||
|
||||
ADRs live on the forge wiki and are cloned into `docs/adr/` during setup (`/setup-matt-pocock-skills`). The source repo ignores `docs/adr/` via `.gitignore`.
|
||||
ADRs live on the forge wiki and are cloned into `docs/adr/` during setup (`setup-skills`). The source repo ignores `docs/adr/` via `.gitignore`.
|
||||
|
||||
- **Reading** — skills read ADRs by relative path (`docs/adr/...`) as before. The wiki clone is transparent.
|
||||
- **Creating / updating** — skills write ADRs to `docs/adr/` as files. Changes accumulate in the wiki clone's local git state.
|
||||
|
||||
@@ -0,0 +1,11 @@
|
||||
# Skill Authoring
|
||||
|
||||
Create and maintain effective agent skills.
|
||||
|
||||
## User-invoked
|
||||
|
||||
No user-invoked skills.
|
||||
|
||||
## Model-invoked
|
||||
|
||||
- [effective-agent-skills](effective-agent-skills/SKILL.md) — Write, review, and debug effective agent skills.
|
||||
@@ -0,0 +1,20 @@
|
||||
# Thinking and Docs Skills
|
||||
|
||||
Clarify decisions, capture ideas, and improve project documentation.
|
||||
|
||||
## User-invoked
|
||||
|
||||
- [before-building](before-building/SKILL.md) — Surface consequential choices when the user proposes a build.
|
||||
- [decisions](decisions/SKILL.md) — List choices made during the current work that remain uncertain.
|
||||
- [level-up](level-up/SKILL.md) — Assess technical and product knowledge and grow a learning plan.
|
||||
- [read-all-adrs](read-all-adrs/SKILL.md) — Read every ADR in the project's `docs/adr/` folder.
|
||||
- [remind](remind/SKILL.md) — Rewrite the last response more simply and briefly.
|
||||
- [short](short/SKILL.md) — Compress the current answer while keeping its substance.
|
||||
- [teach](teach/SKILL.md) — Teach the user a new skill or concept within the workspace.
|
||||
|
||||
## Model-invoked
|
||||
|
||||
- [brain-to-docs](brain-to-docs/SKILL.md) — Extract project vision, decisions, and preferences into documentation.
|
||||
- [next-decision](next-decision/SKILL.md) — Drill into the next unresolved decision with choices and a recommendation.
|
||||
- [prompt-me](prompt-me/SKILL.md) — Ask pointed questions to extract project priorities and concerns.
|
||||
- [save-idea](save-idea/SKILL.md) — Capture content ideas in the user's content backlog.
|
||||
Reference in New Issue
Block a user