Static local documentation

Operational playbooks for coding agents.

A file-based index for the reusable workflows in this folder. Each skill keeps its own source of truth in SKILL.md; this page gives the fast map: what exists, when to use it, and where to open the details.

12documented skills
4workflow scripts
0processes to run

Catalog

Skills by workflow lane

Search by name or behavior. Filters are local JavaScript only and still work when this page is opened from disk.

Kit and Kaboodle

delivery

End-to-end delivery flow from Linear issue kickoff through implementation, browser verification, review, and PR creation.

  • Starts from a Linear issue link or key.
  • Requires browser verification with recordings before PR creation.
  • Chains the start-work, commit-push, and make-pr lanes.
kit-and-kaboodle/SKILL.md Open

Linear Start Work

linear

Starts and carries coding work from a Linear issue by loading full context, researching the repo, creating a branch, moving the issue forward, and implementing the accepted scope with query and failure-safety preflight.

  • Reads parent, child, comment, document, and attachment context.
  • Adds a risk and invariant gate before implementation.
  • Plans production-safe queries, pagination, error handling, and compensation.
  • Continues into code changes and validation after a go preflight.
linear-start-work/SKILL.md Open

Create Linear Issue

linear

Turns a rough product, bug, or planning prompt into real Linear issue records after focused repo and backlog research.

  • Preserves concrete product constraints and source wording.
  • Searches for duplicates before creating new work.
  • Chooses single issue versus parent and sub-issues deliberately.
create-linear-issue/SKILL.md Open

Linear

mcp

General Linear MCP workflow for reading, creating, and updating issues, projects, teams, and workspace context.

  • Documents MCP connection endpoints and setup by agent surface.
  • Used as the foundation for issue and project workflows.
  • Includes local icon assets for richer agent interfaces.
linear/SKILL.md Open

Linear Project Autopilot

linear

Autonomously works through all issues in a Linear project in milestone and priority order until done or human action is needed.

  • Builds a queue across milestones, priority, blockers, and creation date.
  • Stops for API keys, OAuth apps, DNS, purchases, or manual setup.
  • Implements, tests, reviews, opens PRs, merges, and marks issues done.
linear-project-autopilot/SKILL.md Open

Git Add Commit Push

git

Stages all changes, generates a commit message from the diff, commits, and pushes to the current branch with a repeatable script.

  • Runs a zero-input commit and push flow.
  • Refuses to run when there are no changes.
  • Keeps secret safety checks explicit.
git-add-commit-push/SKILL.md Open

Make PR

github

Creates GitHub pull requests from the current branch, including commit and push handling when local changes exist.

  • Discovers the repository default branch before diffing.
  • Creates concise branch summaries for the PR body.
  • Supports draft PRs and optional review tool triggering.
make-pr/SKILL.md Open

GH PR Comment Audit

review

Audits unresolved PR review comments against the branch purpose, traces fix and collection-capacity impact, prevents speculative scope creep, and resolves only justified threads.

  • Supports whole-PR, targeted discussion, thread ID, and next-unresolved modes.
  • Requires a clear branch-purpose gate and evidence before classifying comments as real, stale, or out of scope.
  • Analyzes upstream/downstream effects before making even small fixes.
  • Separates realistic collection-size risks from theoretical pagination or limit concerns.
  • Uses GitHub thread resolution carefully when siblings remain actionable.
gh-pr-comment-audit/SKILL.md Open

Back To Main

git

Returns a repository to the main branch and syncs it with origin using a pruning fetch and fast-forward pull.

  • Fetches with prune before switching.
  • Creates local main from origin when needed.
  • Stops on local-change blockers instead of discarding work.
back-to-main/SKILL.md Open

Skill Sync

meta

Manages the optional project-local copy workflow for teams that want selected private skills checked into a repo.

  • Different from the global sync-skills.sh installer below.
  • Runs from another project repo, then copies agent-skills/<skill> into .shared/skills/<skill>.
  • Creates project-relative symlinks for .claude/skills, .agents/skills, and .gemini/skills.
  • Tracks the private-repo source commit in .shared/skills-manifest.json for update and harvest checks.
  • Provides install, update, update all, harvest, remove, and status commands.
skill-sync/SKILL.md Open

Workflow Retro

meta

Analyzes review feedback patterns from a session and proposes improvements to skills, project config, and persistent retro logs.

  • Collects evidence from the conversation, git log, and PR threads.
  • Classifies findings by preventability and target artifact.
  • Checks existing rules before proposing additions.
workflow-retro/SKILL.md Open

Explain

communication

Turns a dense response, concept, decision, or process into a clear causal story in progressive bullets.

  • Accepts /explain with or without an explicit body.
  • Uses the latest relevant context when no body is supplied.
  • Shows how each event causes the next, including meaningful exceptions.
explain/SKILL.md Open
No skills match this search. Try a workflow noun such as Linear, PR, commit, review, branch, or sync.

How to keep this current

Treat each skill folder as the source of truth. When a skill changes, update its card summary here only if the trigger, workflow lane, or major scripts changed. This page should stay skim-friendly instead of mirroring every line.

Local resources

Two sync paths

The default path is global per agent tool: agent-skills/sync-skills.sh links every skill in this directory into ~/.claude/skills, ~/.codex/skills, and ~/.gemini/skills. It also removes stale symlinks that point back to removed skills in this repo.

The nested agent-skills/skill-sync/scripts/skill-sync.sh script is the project-local option. Use it from another git repo when that project should carry selected skills under .shared/skills/ with project-relative agent symlinks and a manifest recording the source commit.

./sync-skills.shInstall or refresh all private skills globally for Claude, Codex, and Gemini.
install <skill>Project option: copy one private skill into the current project and create project-local agent symlinks.
statusCompare installed skills against the private repo and report local or upstream drift.
update <skill>Replace the project copy with the newer private-repo version and update the manifest commit.
update --allRun update checks for every skill listed in the project manifest.
harvest <skill>Copy project-local skill edits back into the private repo for review and commit.
remove <skill>Delete the shared copy, remove agent symlinks, and clean the manifest.