Agent skill · Code Review & Quality

recipe-update-doc

Update existing design documents (Design Doc / PRD / ADR) with review

shinprgithub.com/shinprGitHub ↗
claude-codeMIT
Install
npx skills add shinpr/claude-code-workflows --skill recipe-update-doc --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 9 KB
Bundled scripts: none
Path: skills/recipe-update-doc/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 664
Language: JavaScript

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

Execute Skill: llm-friendly-context before writing Agent prompts, handoffs, or generated artifacts. Execute Skill: subagents-orchestration-guide before making workflow decisions, invoking agents, or resolving findings. **Context**: Dedicated to updating existing design documents. ## Orchestrator Definition **Core Identity**: "I am an orchestrator." (see subagents-orchestration-guide skill) **Local authority gate**: Make this recipe's workflow decisions and validate each returned result directly; delegate semantic deliverable production to the named specialist. **Review Resolution Gate [MANDATORY]**: Resolve every actionable deliverable-review finding through subagents-orchestration-guide `Review Resolution` before correction or progression. Before the first finding disposition, read `references/review-resolution.md` from the loaded subagents-orchestration-guide skill. **First Action**: Register Steps 1-6 using TaskCreate before any execution. **Execution Protocol**: 1. **Invoke named specialists for deliverable production** — pass deliverable paths between them and validate their results (see subagents-orchestration-guide "Orchestrator Execution Boundary") 2. **Execute update flow*

What's inside
Steps it walks through
  1. Orchestrator Definition
  2. Workflow Overview
  3. Scope Boundaries
  4. Execution Flow
  5. Step 1: Target Document Identification
  6. Step 2: Document Type and Layer Determination
  7. Step 3: Change Content Clarification [Stop]
  8. Step 4: Document Update
  9. Step 5: Document Review [Stop]
  10. Step 6: Consistency Verification (Design Doc only) [Stop]
  11. Error Handling
  12. Completion Criteria
  13. Output Example
Commands it runs
Check existing documents
ls docs/design/*.md docs/prd/*.md docs/adr/*.md 2>/dev/null | grep -v template
More from claude-code-workflows
All skills →
About this skill
What does the recipe-update-doc skill do?

Update existing design documents (Design Doc / PRD / ADR) with review

How do I install it?

Run `npx skills add shinpr/claude-code-workflows --skill recipe-update-doc --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From shinpr/claude-code-workflows, a repository with 664 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going