dot_claude/skills/docs/SKILL.md
--- name: docs description: "Audit and fix documentation drift — stale docstrings, missing docs on public APIs, outdated README sections. Spawns the doc-auditor agent." allowed-tools: Read, Glob, Grep, Edit, Write, Bash(git diff:*), Bash(git branch:*) argument-hint: [file/dir|staged|all] [--dry-run] --- ## Context - Branch: !`git branch --show-current` - Changed files: !`git diff --name-only HEAD` ## Task Audit documentation for the specified target by spawning the `doc-auditor` agent. ### T
npx skillsauth add letstakeawalk/dotfiles dot_claude/skills/docsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
git branch --show-currentgit diff --name-only HEADAudit documentation for the specified target by spawning the doc-auditor agent.
$ARGUMENTS specifies a path, "staged", or "all", pass it through directlySpawn the doc-auditor agent with the resolved target:
$ARGUMENTS (or the default) as the agent's inputDefault: after presenting the report, automatically fix trivial issues:
@param / @returns tags that don't match the current signatureLeave anything requiring judgment (rewriting explanations, updating README sections, clarifying ambiguous docs) as remaining items for the user to address.
With --dry-run: present the report only, do not auto-fix anything.
development
Analyze test coverage gaps — untested public APIs, missing edge cases, uncovered error paths. Spawns the test-analyzer agent.
tools
--- name: review description: "Code review — detects language and spawns the appropriate reviewer agent. Works with diffs, staged changes, files, or directories." allowed-tools: Read, Glob, Grep, Edit, Write, Bash(git diff:*), Bash(git log:*), Bash(git status:*), Bash(git branch:*) argument-hint: [file/dir|staged|lang] [security|performance|idioms|bugs|tests] [--fix] [--deep] --- ## Context - Branch: !`git branch --show-current` - Changed files: !`git diff --name-only HEAD` - Diff stats: !`git
testing
This skill should be used when the user says 'remember this', 'save this for later', 'note this down', 'always do X', 'never do Y', or wants to persist a decision or preference across sessions.
tools
--- name: refactor description: "Identify and apply refactoring opportunities — supports full analysis, cleanup, simplify, structure, naming, and DRY focus modes." allowed-tools: Read, Glob, Grep, Edit, Write, Bash(git diff:*), Bash(git branch:*) argument-hint: [file/dir|staged] [full|cleanup|simplify|structure|naming|dry] --- ## Context - Branch: !`git branch --show-current` - Changed files: !`git diff --name-only HEAD` - Diff stats: !`git diff --stat HEAD` ## Task Analyze code for refactori