Subagents, slash commands, skill scaffolder, and discoverability pass (#28)
Growth-focused additions drawn from studying alirezarezvani/claude-skills — broaden content types beyond skills, lower contribution friction, and improve discoverability. Breadth (content types): - agents/ — 4 Claude Code subagents (pm-partner, sprint-master, cs-guardian, launch-captain) that delegate to the strongest skills and run their helper scripts to compute results. - commands/ — 6 slash commands (/prd, /rice, /sprint-plan, /health-scorecard, /retro, /exec-summary). - install.sh --agent claude now installs skills + agents + commands into ~/.claude/. Contribution UX: - scripts/new-skill.mjs (npm run new-skill) scaffolds a SKILL.md that already passes SkillCheck. - package.json exposes npm run entry points (new-skill, skillcheck, build:exports, build:web, check). Discoverability: - Keyword-rich README H1 (Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes), subagent/command count badges, a Subagents & Slash Commands section, and a Star History chart. Contributing now points at the scaffolder. CHANGELOG updated. SkillCheck, exports, and web index all verified in sync. Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,22 @@
|
||||
# Slash Commands
|
||||
|
||||
Claude Code **slash commands** that run a skill on whatever you pass them.
|
||||
|
||||
| Command | Does | Skill |
|
||||
|---|---|---|
|
||||
| `/prd` | Draft a PRD from an idea | prd-template |
|
||||
| `/rice` | Score & rank initiatives (RICE) | rice-prioritisation |
|
||||
| `/sprint-plan` | Plan a sprint with a calibrated commitment | sprint-planning |
|
||||
| `/health-scorecard` | Weighted customer health scorecard | cs-health-scorecard |
|
||||
| `/retro` | Structured sprint retrospective | retro-analysis |
|
||||
| `/exec-summary` | Crisp executive summary | executive-summary |
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
./scripts/install.sh --agent claude # installs skills + agents + commands into ~/.claude/
|
||||
# or copy manually:
|
||||
cp commands/*.md ~/.claude/commands/
|
||||
```
|
||||
|
||||
Then run, e.g. `/rice` followed by your initiatives. Commands whose skill ships a Python helper (RICE, sprint, health) will run it to compute results.
|
||||
@@ -0,0 +1,8 @@
|
||||
---
|
||||
description: Compress a document or update into a crisp executive summary.
|
||||
argument-hint: [text, decision, or document to summarise]
|
||||
---
|
||||
|
||||
Apply the **executive-summary** skill to: $ARGUMENTS
|
||||
|
||||
Lead with the decision or "so what", then the key points and the ask. Keep it scannable, quantify where possible, and surface risks and the recommendation up front. No filler.
|
||||
@@ -0,0 +1,8 @@
|
||||
---
|
||||
description: Build a weighted customer health scorecard for an account.
|
||||
argument-hint: [account name + usage/support/commercial signals]
|
||||
---
|
||||
|
||||
Apply the **cs-health-scorecard** skill to: $ARGUMENTS
|
||||
|
||||
Score each dimension 1–5 with specific evidence, then run `skills/cs-health-scorecard/scripts/health_score.py` to compute the weighted /100 total and RAG band. Produce the scorecard, top risks (specific, not vague), owned/dated actions, and a calibrated renewal forecast with ARR at risk.
|
||||
@@ -0,0 +1,8 @@
|
||||
---
|
||||
description: Draft a product requirements document from a feature idea or brief.
|
||||
argument-hint: [feature or problem to spec]
|
||||
---
|
||||
|
||||
Apply the **prd-template** skill to produce a complete PRD for: $ARGUMENTS
|
||||
|
||||
Ask for any missing essentials first (problem, target user, success metric, scope). Do not invent metrics or dates. Produce a structured PRD with problem, goals/non-goals, user stories, requirements, success metrics, and open questions.
|
||||
@@ -0,0 +1,8 @@
|
||||
---
|
||||
description: Run a structured sprint retrospective from notes.
|
||||
argument-hint: [what happened this sprint — wins, misses, blockers]
|
||||
---
|
||||
|
||||
Apply the **retro-analysis** skill to: $ARGUMENTS
|
||||
|
||||
Surface themes (what went well, what didn't, what to change), separate symptoms from root causes, and end with owned, dated action items. Keep it blameless and specific.
|
||||
@@ -0,0 +1,8 @@
|
||||
---
|
||||
description: Score and rank initiatives with the RICE framework.
|
||||
argument-hint: [list of initiatives, or a file/path of them]
|
||||
---
|
||||
|
||||
Apply the **rice-prioritisation** skill to: $ARGUMENTS
|
||||
|
||||
Gather or estimate Reach, Impact, Confidence, and Effort for each item. If the data is structured, run `skills/rice-prioritisation/scripts/rice_calculator.py` to compute and rank the scores and flag quick wins / moonshots / low-confidence items. Present a ranked table, a recommended sequence, and the data gaps that would most improve accuracy.
|
||||
@@ -0,0 +1,8 @@
|
||||
---
|
||||
description: Plan a sprint with a calibrated, realistic commitment.
|
||||
argument-hint: [team size, velocity, backlog items, known absences]
|
||||
---
|
||||
|
||||
Apply the **sprint-planning** skill using: $ARGUMENTS
|
||||
|
||||
Run `skills/sprint-planning/scripts/capacity_calculator.py` with the team's numbers to compute the recommended commitment (cap at ~80% of velocity). Produce an outcome-focused sprint goal, a capacity-fit backlog with acceptance criteria, carry-over accounting, risks, and a planning agenda. Flag any 8+ point story for splitting.
|
||||
Reference in New Issue
Block a user