sd0xdev/doc-refactor
skills/doc-refactor/SKILL.md
Refactor documents — simplify without losing information, visualize flows with sequenceDiagram.
$ install --global
skillsauthnpx skillsauth add sd0xdev/sd0x-dev-flow doc-refactorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 18, 2026, 4:12 AM401.7s1 file scanned
SKILL.md
- name:
- doc-refactor
- description:
- Refactor documents — simplify without losing information, visualize flows with sequenceDiagram.
- allowed-tools:
- Read, Grep, Glob, Edit, Agent
Document Refactoring
Trigger
- Keywords: refactor doc, simplify document, doc-refactor, condense document
When NOT to Use
- Code refactoring (use
/simplifyor/refactor) - Document review without changes (use
/codex-review-doc) - Writing new documents (use
/tech-specor/create-request)
Agent Dispatch
Dispatch to the dedicated doc-refactor agent:
Agent({
description: "Refactor document — simplify without losing information",
subagent_type: "doc-refactor",
prompt: `Refactor the document at: $ARGUMENTS
Follow the task steps and simplification standards defined in this skill.`
})
Task
For the file specified by $ARGUMENTS:
-
Analyze original content
- Count lines
- Identify core information vs redundancy
-
Refactor
- Long paragraphs -> tables
- Steps -> sequenceDiagram
- Duplicates -> single source
-
Validate
- Key information preserved
- Line count reduced
Simplification Standards
| File Type | Target Lines | |-----------|-------------| | CLAUDE.md | < 50 | | rules/.md | < 30 | | agents/.md | < 50 |
Output
## Refactoring Result
- Original: X lines
- Simplified: Y lines (-Z%)
## Changes
- <summary>
Related Skills
sd0xdev/zh-tw
documentation
VerifiedTrustedCommunity
Rewrite the previous reply in Traditional Chinese
147SKILL.mdUpdated Apr 28, 2026
sd0xdev/watch-ci
development
VerifiedTrustedCommunity
Monitor GitHub Actions CI runs until completion. Use when: watching CI after push, checking build status, monitoring PR checks, waiting for CI completion, user says 'watch CI', 'check CI', 'CI status', 'monitor build', or /watch-ci. Not for: pushing code (use push-ci), creating PRs (use create-pr). Output: per-run verdict (pass/fail/timeout).
147SKILL.mdUpdated Apr 28, 2026
sd0xdev/verify
development
VerifiedTrustedCommunity
Verification loop — lint -> typecheck -> unit -> integration -> e2e
147SKILL.mdUpdated Apr 28, 2026
sd0xdev/update-docs
development
VerifiedTrustedCommunity
Research current code state then update corresponding docs, ensuring docs stay in sync with code.
147SKILL.mdUpdated Apr 28, 2026