gitadmin 18ef02a331 feat: add orchestrate-herdr skill and dual-review; make to-spec/to-tickets agent-invocable
Add an explicitly invoked Pi orchestration skill that drives a plan from the
current conversation or an @file through a published spec, linked dependency-aware
tickets, and one-at-a-time isolated implementation to a merged PR, using Herdr
and Pi agents with no Bun CLI or orchestration runtime.

- orchestrate-herdr (SKILL.md + dispatcher/run-loop/state references): worker-node
  selection and Herdr discovery/validation, plan-and-publish, one-at-a-time task
  loop (claim, isolate, implement, verify, four-axis review, scoped fix rounds max
  three, transient retries max two, reconcile uncertain side effects, escalate),
  PR/merge/close gates, authoritative worker-node state, cross-system recovery,
  and owned-only cleanup that preserves dirty worktrees and retained state.
- dual-review: self-contained correctness/security + maintainability review axis
  (four-axis review with code-review).
- to-spec and to-tickets: drop disable-model-invocation so the orchestration
  workflow can invoke them.
- READMEs: list the two new skills.
2026-10-06 12:45:12 -04:00

Skills

Agent skills (slash commands and behaviors) loaded into AI coding agents.

Skills are grouped by invocation type. User-invoked skills run only when a person invokes them; model-invoked skills can also be selected automatically.

User-invoked

Engineering

  • commit-staged — Commit staged files with a conventional commit message.
  • grill-with-docs — Interview the user to sharpen a plan or design while creating ADRs and glossary docs.
  • implement — Implement a piece of work from a spec or set of tickets.
  • implement-isolation — Implement a piece of work from a spec or set of tickets in isolation.
  • implement-isolation-tmux — Dispatch an isolated worktree agent to implement work from a PRD or issues.
  • improve-codebase-architecture — Find and work through opportunities to deepen a codebase's architecture.
  • orchestrate-herdr — Drive a plan from context or @file through a published spec, linked tickets, and one-at-a-time isolated implementation to a merged PR using Herdr and Pi agents.
  • project-context-pack — Build a bounded project context pack for later agent work.
  • recipe-diagrams — Convert recipes into high-resolution process-flow diagrams.
  • setup-skills — Configure engineering skills, issue tracking, triage labels, and domain docs.
  • to-spec — Turn the current conversation into a spec and publish it to the issue tracker.
  • to-tickets — Break a plan or spec into tracer-bullet tickets with dependencies.
  • triage — Triage issues and external PRs through the project workflow.
  • wayfinder — Plan large work as decision tickets and resolve them step by step.

In-progress

  • agent-handoff — Hand the current conversation to a fresh background agent.
  • knowledge-gardener — Run vault-aware search, synthesis, note creation, and linking workflows.

Miscellaneous

  • bro — Restate the last message in plain human language.
  • show-me — Help explain topics visually with concise diagrams and artifacts.
  • tmux-launch-agent — Fork a new agent CLI session into a new tmux window.
  • visual-verification — Verify running desktop UI changes with screenshots and recordings.

Personal

  • arch-maintenance — Keep an Arch/CachyOS system updated and healthy with status, check, and update workflows.
  • arch-troubleshooting — Diagnose and repair Arch/CachyOS system problems.

PKM

  • conversation-summary — Save the current conversation as a report note in an Obsidian vault.
  • crit — Run the CRIT framework through context, role, interview, and task.
  • research-vault — Research a topic through a guided conversation and save a linked vault packet.
  • youtube-video-capture — Capture a YouTube video's subtitles and summary in an Obsidian vault.

Productivity

  • grill-me — Interview the user to sharpen a plan or design.
  • handoff — Compact the current conversation into a handoff document.
  • teach — Teach the user a new skill or concept within the workspace.
  • to-questionnaire — Turn an unresolved decision into a questionnaire.
  • wait-what — Re-pitch the last message in clearer terms.

Skill authoring

No user-invoked skills.

Thinking and docs

  • before-building — Surface consequential choices when the user proposes a build.
  • decisions — List choices made during the current work that remain uncertain.
  • level-up — Assess technical and product knowledge and grow a learning plan.
  • read-all-adrs — Read every ADR in the project's docs/adr/ folder.
  • remind — Rewrite the last response more simply and briefly.
  • short — Compress the current answer while keeping its substance.
  • teach — Teach the user a new skill or concept within the workspace.

Model-invoked

Engineering

  • code-review — Review changes against repository standards and the originating specification.
  • codebase-design — Design and improve deep module interfaces and seams.
  • dual-review — Run parallel correctness/security and maintainability reviews of a branch diff, then synthesize findings.
  • diagnosing-bugs — Diagnose hard bugs and performance regressions.
  • domain-modeling — Build and sharpen a project's domain model.
  • lsp-code-analysis — Navigate code and analyze it semantically with LSP.
  • prototype — Build a throwaway prototype to answer a design question.
  • research — Investigate a question using high-trust sources and capture the findings.
  • resolving-merge-conflicts — Resolve an in-progress Git merge or rebase conflict.
  • tdd — Use test-driven development for features, bugs, and integration tests.
  • wizard — Generate an interactive wizard for steps only a human can perform.
  • worktrees — Manage Git worktrees in a canonical repository root.
  • write-discoverable-code — Write code agents and humans can find through plain-text search.

Miscellaneous

PKM

  • pkm-curation — Curate an Obsidian vault with classification, links, and atomic notes.

Productivity

Skill authoring

Thinking and docs

  • brain-to-docs — Extract project vision, decisions, and preferences into documentation.
  • next-decision — Drill into the next unresolved decision with choices and a recommendation.
  • prompt-me — Ask pointed questions to extract project priorities and concerns.
  • save-idea — Capture content ideas in the user's content backlog.
S
Description
No description provided
Readme
759 KiB
Languages
Python 53.4%
Shell 46.6%