adrianfernandezalv/skills
Claude Code skills for an AI-assisted development pipeline — from idea to shipped code.
Installation
Install all skills globally:
npx skills@latest add adrianfernandezalv/skills -y -g
Install a single skill:
npx skills@latest add adrianfernandezalv/skills skill=<name> -y -g
The installer detects which agents you have installed (Claude Code, Cursor, Codex, etc.) and creates symlinks automatically for each. The skills are written and optimized for Claude Code — behavior on other agents may vary.
Pipeline
The skills are designed to work together end-to-end:
/grill-me → clarify your idea
/grill-with-docs → stress-test against your codebase's domain model
/to-prd → turn the conversation into a structured PRD
/to-issues → break the PRD into independently-grabbable slices
/tdd → implement each slice with red-green-refactor
/improve-codebase-architecture → find deepening opportunities after implementation
/journal → reconstruct today's work from git history (work vs personal)
/handoff → write a handoff comment on the active issue
Skills
Engineering
| Skill | Description |
|---|
grill-with-docs | Stress-test a plan against the codebase's domain model (CONTEXT.md, ADRs) and update docs inline |
to-prd | Turn the current conversation into a structured PRD |
to-issues | Break a PRD into independently-grabbable implementation slices |
tdd | Red-green-refactor TDD loop for features and bug fixes |
improve-codebase-architecture | Find refactoring opportunities and deepen module boundaries |
Productivity
| Skill | Description |
|---|
grill-me | Interview to reach shared understanding before starting work |
journal | Reconstruct today's work from git history across your repos, split work vs personal |
handoff | Write a handoff comment on the active issue for the next session |
Integrations
Four skills (to-prd, to-issues, journal, handoff) persist state across sessions and adapt to a configurable backend. Backends dispatch independently, so combinations (e.g. GitHub issues + Inkdrop journal) work out of the box.
Issue backend — output: in CLAUDE.local.md
Selects where to-prd / to-issues / handoff write. Default is github when the key is absent.
output: | PRD | Slices | Handoff |
|---|
github (default) | Epic tracking issue (label epic), PRD in the body | Native sub-issues of the Epic, type:/status: labels, release as milestone | Comment on the active issue |
jira | Jira ticket description | Child Jira issues with blocking links | Comment on the ticket |
inkdrop | Spec notebook note | Issues notebook notes, type + release tags | ## Handoff section in the issue note |
With github, issue status is tracked by labels (no GitHub Project needed): status: to-define → status: selected-for-dev → status: in-progress → closed (Done); wontfix = dropped. Labels and milestones are created on-demand.
Journal backend — journal-backend in ~/.claude/CLAUDE.md
/journal reconstructs the day from git history and writes it where journal-backend says (journal-path gives the location):
journal-backend | Behavior |
|---|
obsidian (default) | Writes <journal-path>/<date>.md and commits it (vault is a git repo) |
inkdrop | One note per day in the Journal notebook |
/journal scans journal-roots for repos, attributes commits via journal-emails (all your identities, across all branches), and optionally splits Work vs Personal by journal-work-hosts:
# ~/.claude/CLAUDE.md
journal-backend: obsidian
journal-path: ~/notes/Journal
journal-roots: ~/code # dirs to scan for git repos
journal-emails: [email protected], [email protected]
journal-work-hosts: git.company.com # optional — marks matching repos as "work"
Repository conventions
Some skills expect specific files to exist in your project. Create them once and the skills will use them automatically:
| File | Used by | Purpose |
|---|
CONTEXT.md | grill-with-docs, improve-codebase-architecture, tdd | Domain glossary — canonical terms and relationships for this codebase |
docs/adr/ | grill-with-docs, improve-codebase-architecture | Architectural Decision Records — decisions the skills won't re-litigate |
CLAUDE.local.md | to-prd, to-issues, handoff | Project-level config (output: selects the issue backend; default github) |
CONTEXT.md and docs/adr/ are created lazily by the skills themselves the first time they're needed — you don't have to set them up manually.
Credits
Based on mattpocock/skills by Matt Pocock, MIT license.
