Update Skill Content

Update the content of an existing SKILL.md to improve accuracy, completeness, and clarity. Covers version bumping, procedure refinement, pitfall expansion, and related skills synchronization. Use when a skill's procedures reference outdated tools or APIs, the Common Pitfalls section is thin, Related Skills has broken cross-references, or after receiving feedback that a skill's procedures are unclear or incomplete.

45 stars 4 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add pjt222/agent-almanac --skill update-skill-content
Manual install
git clone --depth 1 https://github.com/pjt222/agent-almanac.git /tmp/agent-almanac
mkdir -p ~/.claude/skills
cp -r /tmp/agent-almanac/i18n/caveman-lite/skills/update-skill-content ~/.claude/skills/update-skill-content

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Update Skill Content

Improve an existing SKILL.md by refining procedure steps, expanding Common Pitfalls with real failure modes, synchronizing the Related Skills section, and bumping the version number. Use this after a skill passes format validation but has content gaps, stale references, or incomplete procedures.

## When to Use

- A skill's procedure steps reference outdated tools, APIs, or version numbers
- Common Pitfalls section is thin (fewer than 3 pitfalls) or missing real failure modes
- Related Skills section has broken cross-references or is missing relevant links
- Procedure steps lack concrete code examples or have vague instructions
- A new skill has been added to the library that should be cross-referenced from existing skills
- After receiving feedback that a skill's procedures are unclear or incomplete

## Inputs

- **Required**: Path to the SKILL.md file to update
- **Optional**: Specific section(s) to focus on (e.g., "procedure", "pitfalls", "related-skills")
- **Optional**: Source of updates (changelog, issue report, user feedback)
- **Optional**: Whether to bump version (default: yes, minor bump)

## Procedure

### Step 1: Read Current Skill and Assess Content Quality

Read the entire SKILL.md and evaluate each section for completeness and accuracy.

Assessment criteria per section:
- **When to Use**: Are triggers concrete and actionable? (3-5 items expected)
- **Inputs**: Are types, defaults, and required/optional clearly separated?
Read the full skill on GitHub

Details

Skill name
update-skill-content
Path
i18n/caveman-lite/skills/update-skill-content/SKILL.md
License
MIT
Repo updated
18 November 2026

FAQ

What does the Update Skill Content skill do?

Update the content of an existing SKILL.md to improve accuracy, completeness, and clarity. Covers version bumping, procedure refinement, pitfall expansion, and related skills synchronization. Use when a skill's procedures reference outdated tools or APIs, the Common Pitfalls section is thin, Related Skills has broken cross-references, or after receiving feedback that a skill's procedures are unclear or incomplete.

How do I install the Update Skill Content skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add pjt222/agent-almanac --skill update-skill-content. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Update Skill Content popular?

It lives in pjt222/agent-almanac, which has 45 GitHub stars and 4 forks, and is included in 1 curated skill list.

Related skills

Adapt Architecture

45

pjt222/agent-almanac

Execute structural metamorphosis using strangler fig migration, chrysalis phases, and interface preservation. Covers transformation planning, parallel running, progressive cutover, rollback design, and post-metamorphosis stabilization for system architecture evolution. Use when assess-form has classified the system as READY for transformation, when migrating from monolith to microservices, when replacing a core subsystem while dependents continue operating, or when any architectural change must be gradual rather than big-bang.

Software DevelopmentIn 1 list

Adaptic

45

pjt222/agent-almanac

Master skill composing the 5-step synoptic cycle for panoramic synthesis across multiple domains. Orchestrates meditate, expand-awareness, observe, awareness, integrate-gestalt, and express-insight into a coherent process that produces unified understanding rather than sequential compromise. Use when a problem genuinely spans 3+ domains and the interactions between domains matter more than depth in any one, when sequential analysis feels like compromise rather than integration, or before major architectural decisions affecting multiple stakeholders.

OtherIn 1 list

Add Puzzle Type

45

pjt222/agent-almanac

Scaffold a new puzzle type across all 10+ pipeline integration points in jigsawR. Creates the core puzzle module, wires it into the unified pipeline (generation, positioning, rendering, adjacency), adds ggpuzzle geom/stat layers, updates DESCRIPTION and config.yml, extends the Shiny app, and creates a comprehensive test suite. Use when adding a completely new puzzle type to the package or following the 10-point integration checklist to ensure nothing is missed end-to-end.

Testing & QAIn 1 list

Write Continue Here

45

pjt222/agent-almanac

Write a CONTINUE_HERE.md file capturing current session state so a fresh Claude Code session can pick up where this one left off. Covers assessing recent work, structuring the continuation file with objective, completed, in-progress, next-steps, and context sections, and verifying the file is actionable. Use when ending a session with unfinished work, handing off context between sessions, or preserving task state that git alone cannot capture.

Writing & ContentIn 1 list

Translate Content

45

pjt222/agent-almanac

Translate agent-almanac content (skills, agents, teams, guides) into a target locale while preserving code blocks, IDs, and technical structure. Covers scaffolding, frontmatter setup, prose translation, code preservation, and freshness tracking. Use when localizing content for a new language, updating stale translations after source changes, or batch-translating a domain.

Writing & ContentIn 1 list

Write Incident Runbook

45

pjt222/agent-almanac

Create structured incident runbooks with diagnostic steps, resolution procedures, escalation paths, and communication templates for effective incident response. Use when documenting response procedures for recurring alerts, standardizing incident response across an on-call rotation, reducing MTTR with clear diagnostic steps, creating training materials for new team members, or linking alert annotations directly to resolution procedures.

Writing & ContentIn 1 list

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.