Refactor Docs
Split oversized or multi-topic docs into focused files with progressive disclosure
Install
$ agentstack add skill-paulo-yamagishi-claude-code-setup-refactor-docs ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Links to your public security report.[](https://agentstack.voostack.com/security/report/skill-paulo-yamagishi-claude-code-setup-refactor-docs) Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Refactor Docs
Split oversized or multi-topic documentation files into focused, smaller files following progressive disclosure principles.
Steps
- Determine scope:
- If
$ARGUMENTSis a file path, analyze only that file - If
$ARGUMENTSis a directory, analyze all.mdfiles in it - If
$ARGUMENTSis empty, scan all.mdfiles in:core/,projects/,templates/,skill/,.claude/skills/,.claude/rules/
- Identify candidates: For each file, flag if:
- Over 300 lines
- Covers multiple distinct topics (detected by counting
##sections on unrelated subjects) - Has large reference sections that could be extracted
- Propose split strategy for each flagged file:
Core guides: Split into {topic}-guide.md (essentials, <150 lines) + {topic}-reference.md (deep-dive details, examples, edge cases)
CLAUDE.md files: Move detailed sections to separate files importable via @import, keep CLAUDE.md as a concise overview (<100 lines)
Rule files: Break multi-topic rule files into single-topic files, each with appropriate paths frontmatter for scoped loading
Skill files: Extract large reference sections into companion files only if the skill exceeds 250 lines (skills should be self-contained where possible)
- Present the plan with before/after line counts for each file. Wait for user approval before proceeding.
- Execute the refactor:
- Create new files with extracted content
- Update the original file to reference the new files
- Update
@importdirectives in CLAUDE.md if applicable - Update cross-references in other files that linked to the original
- Verify: After refactor, confirm:
- No broken cross-references (Grep for old paths, check they've been updated)
- All new files are under 300 lines
- No content was lost in the split
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: paulo-yamagishi
- Source: paulo-yamagishi/claude-code-setup
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.