Skip to content
Skills Library
Programming · Automation

docs-refresh

/docs-refresh

Refresh documentation with deterministic generation from source files. Use when user says /docs-refresh.

Repository
skills ↗
Licence
MIT
Last repository change
21.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
5
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 21.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Refresh documentation with deterministic generation from source files. Use when user says /docs-refresh.

Original author description

Refresh documentation with deterministic generation from source files. Use when user says /docs-refresh.

How it works

  1. Purpose
  2. Quick Reference
  3. Commands
  4. Outputs
  5. CLAUDE.md Skills Table
  6. When It Fails
  7. Automation
Original SKILL.md headings · 51 lines, 179 words
SKILL.md preview
---
name: docs-refresh
description: Refresh documentation with deterministic generation from source files. Use when user says /docs-refresh.
user-invocable: true
allowed-tools:
  - Read
  - Bash
  - Glob
  - Grep
  - Edit
  - Write
hooks:
  Stop:
    - type: command
      command: "task claude:validate-skill -- --skill docs-refresh"
---

# Docs Refresh

## Purpose

Keep generated documentation in sync with source files. Manages skill reference documentation and project-level Claude instructions.

## Quick Reference

- **Manages**: `docs/skills/REFERENCE.md`, `CLAUDE.md` (skills table)
- **Sources**: `.claude/skills/*/skill.yaml`
- **Stop hook**: `task claude:validate-skill -- --skill docs-refresh`

## Commands

```bash
# Regenerate all documentation
task docs:refresh

# Check if docs are in sync (CI mode)
task docs:refresh-check

# Regenerate skills reference only
task claude:skills-reference
```

## Outputs

| Artifact | Purpose |
|----------|---------|
| `docs/skills/REFERENCE.md` | Generated skill inventory with patterns and ownership |
| `CLAUDE.md` | Project instructions for Claude (includes skills table) |

## CLAUDE.md Skills Table

The skills table in `CLAUDE.md` lists all skills and when to use them. When adding/removing skills:

1. Update the skills table in `CLAUDE.md`
2. Run `task docs:refresh` to regenerate REFERENCE.md
3. Commit both files together

## When It Fails

1. **Skill reference out of sync**: Run `task docs:refresh` to regenerate
2. **Skill YAML invalid**: Fix syntax errors in skill.yaml files

## Automation

See `skill.yaml` for the full procedure and patterns.
See `sharp-edges.yaml` for common failure modes.
Files in this package (5)
  • SKILL.md 2 KB
  • collaboration.yaml 1 KB
  • sharp-edges.yaml 3 KB
  • skill.yaml 3 KB
  • validations.yaml 1 KB

Versions

The database has no other skills named docs-refresh.

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 52328a22544d (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100docs-audit-and-refresh
    Audit the repository's docs/ content against the current codebase, find missing, incorrect, or stale documentation, and refresh the affected pages. Use when the user asks to review docs coverage, find outdated docs, compare docs with the current repo, or fix documentation drift…
  • 100arch-docs
    Create or refresh `docs/CODE_ARCHITECTURE.md` and `docs/FILE_STRUCTURE.md` from repository evidence. Use for architecture or file-layout documentation. Use other documentation skills for README, installation, usage, or repo-wide updates.
  • 100refresh-documentation
    Review and update all project documentation to keep it accurate and current. Use this skill when asked to refresh, update, or audit documentation, README files, AGENTS.md files, skill descriptions, or any markdown docs across the codebase.
  • 98check-third-party-docs
    Refresh this repo's cached upstream/third-party docs and propose improvements to the local skills/docs that wrap those tools. Use when the user says 'check for updated third party docs', 'check for updated third-party docs to improve our docs', 'refresh the cached docs', or 'sync upstream docs'.
  • 100r-refresh
    Use when the codebase has drifted from its governance docs and you want them re-derived from source.
  • 100document-features
    Generate and refresh the public feature documentation in docs/public/features/ - scan the code to decide what is implemented, screenshot the running app, and update the pages. Triggers on "/document-features", "document the features", "refresh feature screenshots", "regenerate feature docs".

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.