Cmd Docs Idiot Proof
Simplify documentation for clarity and scannability with approval-gated edits
Install
/plugin marketplace add Olshansk/agent-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add Olshansk/agent-skills --skill cmd-docs-idiot-proofgit clone --depth 1 https://github.com/Olshansk/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/cmd-docs-idiot-proof ~/.claude/skills/cmd-docs-idiot-proofPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Simple Docs for Humans and Agents Use this command to write or rewrite documentation so it is simple, fast to scan, and easy to execute. ## Primary Goal - Bias toward simple docs. - Start with the shortest successful path. - Preserve original meaning and factual content while reordering for clarity. ## Required Output Order 1. Quickstart (always first) 2. Main workflow 3. Configuration/reference tables (when relevant) 4. Alternative paths (only when they are true user/code path alternatives) 5. Extra details at the end inside `<details><summary>...</summary>...</details>` ## Approval Gate (Required) - Before editing any file, show a change preview for approval. - Use this exact preview structure for each file: - Additions - Removals - Changes - Show the concrete text to be added, removed, or changed. - Wait for explicit user approval before applying edits. - Apply only the approved edits. - If approval is not granted, do not modify files. ## Core Rules - Optimize for both human readers and agent readers. - Maximize copy-paste command snippets. - Prefer short sections and concise language. - Use Markdown tables when information is structured. - Use Mermaid diagrams when they improve understanding of flow or architecture. - Avoid unnecessary sections. - Avoid "Optional" sections unless they represent an actual alternate path. - Put superfluous/background material at the end. - Add "Code Structure" only when repository layout helps task completion.
Details
- Skill name
cmd-docs-idiot-proof- Repository
- Olshansk/agent-skills
- Path
skills/cmd-docs-idiot-proof/SKILL.md- License
- MIT
- Repo updated
- 18 November 2026
FAQ
What does the Cmd Docs Idiot Proof skill do?
Simplify documentation for clarity and scannability with approval-gated edits
How do I install the Cmd Docs Idiot Proof skill?
Claude Code plugin: /plugin marketplace add Olshansk/agent-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Cmd Docs Idiot Proof popular?
It lives in Olshansk/agent-skills, which has 9 GitHub stars and 0 forks.
Related skills
Cmd Agent Persona Set
9Olshansk/agent-skills
Prime the agent with a behavioral persona for the conversation
Cmd Clean Code
9Olshansk/agent-skills
Improve code readability without altering functionality using idiomatic best practices
Cmd Code What
9Olshansk/agent-skills
Catch the user up on what the agent has been doing in the current session with 3-5 ultra-tight bullet points. Use when the user invokes /cmd-what, asks "what are you doing", "what did you do", "catch me up", "status", "where are we", or otherwise needs a fast situational summary of in-flight agent work.
Cmd Olshanskify
9Olshansk/agent-skills
Apply Olshansky's personal style to docs, code, blog posts, or presentations using template-driven rules. Invoke manually via /cmd-olshanskify — pick a content type, point at the target, and the agent rewrites or proposes edits that match the canonical style guide in templates/.
Wp Webhooks
9morrealev/wordpress-manager
This skill should be used when the user asks to "set up webhooks", "notify external service on publish", "connect WordPress to Zapier", "webhook integration", "event notifications", "content sync webhook", "WooCommerce webhook", "outbound notifications", or mentions automating WordPress event propagation to external services.
Cmd Plan Store
9Olshansk/agent-skills
Capture the current conversation's plan, decisions, and action items into a structured markdown file in the project's plans/ directory. Triggers on "store this plan", "save this plan for later", "document this for later", "write up what we discussed", "create a plan file", or "/cmd-plan-store".
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.