github-docs skill
Draft, rewrite, or audit approachable developer product documentation using an independently expressed interpretation of the GitHub Docs style. Use for product workflows, how-to guides, conceptual overviews, troubleshooting, security guidance, and documentation that should move developers from prerequisites to a verified outcome.
- GitHub stars
- 81
- Files
- 3
- Last commit
- Aug 23, 2026
- License
- MIT
- Allowed tools
- —
What does the github-docs skill do?
github-docs is an agent skill. Draft, rewrite, or audit approachable developer product documentation using an independently expressed interpretation of the GitHub Docs style. Use for product workflows, how-to guides, conceptual overviews, troubleshooting, security guidance, and documentation that should move developers from prerequisites to a verified outcome.
How to install the github-docs skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the github-docs skill in Plugin
/plugin marketplace add Neeeophytee/agent-stylebooks /plugin install agent-stylebooks@agent-stylebooks
Install the github-docs skill in Claude Code
~/.claude/skills/github-docs/SKILL.md
$ npx degit Neeeophytee/agent-stylebooks/skills/github-docs ~/.claude/skills/github-docsInstall the github-docs skill in Claude Code (project)
.claude/skills/github-docs/SKILL.md
$ npx degit Neeeophytee/agent-stylebooks/skills/github-docs .claude/skills/github-docsInstall the github-docs skill in Codex
~/.agents/skills/github-docs/SKILL.md
$ npx degit Neeeophytee/agent-stylebooks/skills/github-docs ~/.agents/skills/github-docsInstall the github-docs skill in Gemini CLI
~/.gemini/skills/github-docs/SKILL.md
$ npx degit Neeeophytee/agent-stylebooks/skills/github-docs ~/.gemini/skills/github-docsInstall the github-docs skill in Claude.ai
npx degit Neeeophytee/agent-stylebooks/skills/github-docs github-docs && zip -r github-docs.zip github-docs # claude.ai → Customize → Skills → + → Create skill → Upload a skill → github-docs.zip
SKILL.md
View on GitHubGitHub docs
Help developers complete a product workflow with accurate, approachable guidance.
Establish the contract
- Preserve commands, UI labels, permissions, plan or product availability, code, versions, and security consequences.
- Do not claim a feature exists for a plan, host, or version without evidence.
- Distinguish a supported workflow from a workaround or community convention.
- Surface missing facts as review questions.
Design the page
- Name the reader's goal in the title and opening.
- State prerequisites, permissions, supported environments, and risks before the reader reaches a dependent action.
- Give only enough concept to make the action understandable and safe.
- Present the shortest supported path first. Place alternatives in separate sections.
- Close the loop with verification, troubleshooting, or a useful next step.
Write for developers
- Address the reader as
youand keep the tone calm and collaborative. - Use active voice and concrete verbs. Name the component that performs an automatic action.
- Define product-specific terms on first use and keep terminology stable.
- Put the most important qualifier near the claim it limits.
- Explain why a step matters when the reason affects security, data, or the choice between alternatives.
- Use inclusive language and examples that do not assume geography, identity, or a single development environment.
- Separate normative instructions from optional suggestions.
Write procedures
- Begin steps with imperative verbs and use one main action per step.
- State the location before the control when the reader must navigate to it.
- Keep commands copyable. Explain substitutions and show the expected output only when it helps verify success.
- Put warnings directly before irreversible or security-sensitive actions.
- Offer recovery paths that state what data or configuration may change.
Make the page scannable
- Use sentence case and front-load meaningful words in headings.
- Use descriptive link text instead of generic destinations.
- Use numbered lists for sequences, bullets for options, and tables for repeated comparisons with the same fields.
- Use backticks for code and literal technical elements. Use bold for visible UI labels.
- Keep notes exceptional. Move essential information into the main flow.
Avoid
- assuming a step is obvious, trivial, or familiar
- long scene-setting introductions and repeated summaries
- vague references to
this,that, orit - blaming the reader in warnings and error explanations
- promises that a workflow is secure, fast, or reliable without scope and evidence
- examples with real personal data, tokens, organization names, or secrets
Final pass
Walk the page as the intended reader. Verify that every prerequisite arrives in time, every control and command is identifiable, branching is explicit, and the reader can tell whether the workflow succeeded.
Read references/provenance.md only for source, attribution, licensing, or maintenance questions.
Files in this skill
3github-docs skill questions
How do I install the github-docs skill in Claude Code?
Run npx degit Neeeophytee/agent-stylebooks/skills/github-docs ~/.claude/skills/github-docs. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the github-docs skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.