khesir-skills

Install a full local workflow pipeline of Claude Code skills — from a raw idea, through a PRD, through issue breakdown, through TDD implementation, through QA, to done. Pick exactly the skills you want, or install all 12 in one command.

Everything the skills produce stays local (issues/ files in your own repo) — no external services, no accounts, no tracking.

npx khesir-skills

The pipeline

The 12 skills in this package form one coherent loop:

grill-me / grill-with-docs   → interrogate a new idea until every design decision is resolved
        ↓
to-prd                       → turn the resolved conversation into issues/prd.md
        ↓
to-issues                    → break the PRD into independently-gradable issue files (issues/ready, issues/backlog)
        ↓
implement-issues             → TDD loop: red → green → refactor, issue by issue, until everything reaches issues/qa
        ↓
qa                           → automated build/test/lint/review pass + a visual QA checklist for human eyes
        ↓
qa-approve / qa-reject       → sign off an issue into issues/done, or bounce it back to ready/ with a bug attached
        ↓
new-feature                  → archive the finished issues/ folder and start the next cycle

Two more skills support the loop at any point:

• bug-report — turn something a user described as broken into a proper issue in issues/ready/
• review — a holistic Standards + Spec check across everything you've built so far
• handoff — compact the current conversation into a document for another agent/session to pick up

Prerequisites

• Node.js 18 or later
• Claude Code installed, with access to its skills directory (.claude/skills/ in a project, or ~/.claude/skills/ globally)

Usage

Interactive (recommended)

Run with no flags to get a checklist of all 12 skills and a prompt for where to install them (this project, or globally):

npx khesir-skills

Install everything

npx khesir-skills --all

Install specific skills

npx khesir-skills --skills bug-report,to-prd,to-issues

Install globally instead of to the current project

Combine with either of the above, or use alone (still prompts for which skills to install):

npx khesir-skills --all --global
npx khesir-skills --global

See the full catalog without installing anything

npx khesir-skills --list

By default, skills install to .claude/skills/ in the current project. --global installs to ~/.claude/skills/ instead, available to every project on your machine. Re-running the command overwrites previously installed versions of the skills you select — safe to use as an update mechanism.

Skill catalog

| Skill | What it does | |---|---| | grill-me | Interviews you about a new idea one question at a time until every design decision is resolved, then hands off to to-prd. | | grill-with-docs | Same interview loop as grill-me, but also challenges the idea against your existing domain model and keeps CONTEXT.md/ADRs up to date as you go. | | to-prd | Synthesizes the resolved conversation into a PRD saved at issues/prd.md. | | to-issues | Breaks a PRD into independently-gradable vertical-slice issues, tracked on issues/kanban.md. | | implement-issues | Runs a TDD loop (red → green → refactor) over every ready issue until each one reaches issues/qa/. | | qa | Runs automated build/test/lint/code-review checks on everything in issues/qa/ and generates a visual QA checklist for the parts that need human eyes. | | qa-approve | Signs off one or all reviewed issues, moving them from issues/qa/ to issues/done/. | | qa-reject | Attaches bug details to an issue and sends it back to issues/ready/ for a fix. | | review | A holistic Standards + Spec review of accumulated changes, run in parallel sub-agents, side by side. | | new-feature | Archives the current issues/ folder and starts a fresh cycle for the next feature. | | bug-report | Turns a description of something broken into a validated issue in issues/ready/. | | handoff | Compacts the current conversation into a document another agent/session can pick up from. |

License

MIT — see LICENSE.

Maintainer notes (not for end users)

This section documents what's still outstanding before this package is actually published. It's here for whoever maintains this repo, not for people installing it.

• Repo is live at github.com/Khesir/khesir-skills. Not yet published to npm.
• khesir-skills is confirmed available on the public npm registry (npm view khesir-skills → 404, as of 2026-08-14).
• package.json's repository/homepage/bugs/author fields are filled in and point at the GitHub repo above.
• To publish: npm publish from the repo root (bump version first if this isn't the first release).