user-docs-to-ai-skill

Installation
SKILL.md

<docs_path>$1</docs_path> <output_plugin>$2</output_plugin> <output_skill>$3</output_skill>

User Docs to AI Skill

Converts human-readable documentation in any text or binary format into a Claude Code skill directory. Supports Markdown, PDF, DOCX, PPTX, XLSX, AsciiDoc, RST, HTML, Jupyter notebooks, man pages, config files, and plain text. Uses the MCP file-reader server for binary document formats. The output is consumed by Claude, not humans — every word must serve AI comprehension, not user readability.

Inputs

  • <docs_path/> — GitHub URL (e.g. https://github.com/astral-sh/ty) or local directory path containing documentation
  • <output_plugin/> — name for the output plugin (e.g., ty-skill)
  • <output_skill/> — (optional) name for the skill within the plugin; derived from project name when not provided

Output Contract

Creates plugins/<output_plugin/>/skills/<output_skill/>/ containing:

  • SKILL.md — valid frontmatter + AI-facing workflow instructions + links to all reference files
Related skills

More from jamie-bitflight/claude_skills

Installs
9
GitHub Stars
44
First Seen
Mar 29, 2026