Claude-project-skills-template docs-refresh

Auto-generate skill reference docs and keep CLAUDE.md skills table in sync. Use when user says /docs-refresh.

install

source · Clone the upstream repo

git clone https://github.com/dohernandez/claude-project-skills-template

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/dohernandez/claude-project-skills-template "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/docs-refresh" ~/.claude/skills/dohernandez-claude-project-skills-template-docs-refresh && rm -rf "$T"

manifest: .claude/skills/docs-refresh/SKILL.md

source content

Docs Refresh

Purpose

Auto-generate

docs/skills/REFERENCE.md

from skill.yaml files and keep the CLAUDE.md skills table in sync between

<!-- SKILLS_TABLE_START -->

<!-- SKILLS_TABLE_END -->

markers.

Quick Reference

task docs:refresh          # Generate REFERENCE.md + update CLAUDE.md table
task docs:refresh-check    # Verify docs are in sync (CI gate)
task claude:skills-reference  # Generate REFERENCE.md only

Pipeline

generate-skill-reference.sh

reads all

.claude/skills/*/skill.yaml

and writes

docs/skills/REFERENCE.md

```
update-claude-md.sh
```
reads skill.yaml files and updates the table between CLAUDE.md markers
```
docs-refresh-check.sh
```
regenerates both to temp and diffs against committed versions

When to Run

After creating, renaming, or removing a skill
After changing a skill's
```
description
```
,
```
kind
```
, or
```
when_to_use
```
in skill.yaml
Before committing skill changes (Stop hook runs automatically)

Automation

See

skill.yaml

for patterns, ownership, and anti-patterns. See

sharp-edges.yaml

for common failure modes.