SkillPress

Compile websites, docs, and repositories into agent-ready skill packs.

SkillPress turns scattered source material into a clean SKILL.md package with references, source maps, and a maintenance trail. It is built for people who want Claude, Codex, Cursor, and other coding agents to understand a project, product, API, policy, or knowledge base without pasting the same context again and again.

pip install skillpress
skillpress build https://example.com/docs ./README.md \
  --name "Example Docs" \
  --description "Use when a user asks about Example's public documentation."

Or expose it to an MCP-compatible agent client:

{
  "mcpServers": {
    "skillpress": {
      "command": "skillpress",
      "args": ["mcp"]
    }
  }
}

Output:

skillpress-output/
  example-docs/
    SKILL.md
    skillpress.json
    references/
      source-notes.md
      sources.json

Why It Exists

AI agents are powerful, but they still waste time when knowledge is trapped in long docs, scattered repository files, PDFs, internal notes, or web pages. SkillPress gives that material a portable shape:

• SKILL.md for agent instructions.
• references/source-notes.md for readable context.
• references/sources.json for traceability.
• skillpress.json for regeneration and maintenance.

It is not a web-scraping bypass tool. It is a public-source and local-document compiler for responsible agent workflows.

Features

• Build a skill from URLs, files, or folders.
• Scan common text/code formats from repositories.
• Extract readable text from HTML with no heavy dependencies.
• Generate source-grounded references for agent answers.
• Validate a skill pack before sharing it.
• Zip a skill pack for release or installation.
• Run a stdio MCP server for agent clients.
• Works with Python standard library only.

Commands

Create a skill from public docs and local files:

skillpress build https://example.com/docs ./docs \
  --name "Example Product" \
  --description "Use when answering questions about Example Product."

Create an empty skeleton:

skillpress new "Support Playbook" \
  --description "Use when drafting support replies from the team playbook."

Inspect a skill:

skillpress inspect skillpress-output/example-product
skillpress inspect skillpress-output/example-product --json

Package a skill:

skillpress pack skillpress-output/example-product

Run the MCP server:

skillpress mcp

Use Cases

• Turn a GitHub repository into an onboarding skill.
• Turn product docs into a support-agent skill.
• Turn an API reference into a coding-agent skill.
• Turn research notes into a repeatable analysis skill.
• Turn a public website into a compact knowledge pack.

Design Goals

• Portable: the output is just files.
• Transparent: sources are traceable.
• Local-first: no account or hosted service required.
• Agent-friendly: instructions are written for tools that can read SKILL.md.
• Responsible: built for authorized local files and public documentation.

Roadmap

• PDF and DOCX source support.
• Better source ranking and deduplication.
• Browser-rendered page capture for JavaScript-heavy documentation.
• Remote MCP transport for hosted deployments.
• Skill templates for support, API docs, repo onboarding, and research briefs.
• Gallery of high-quality example skill packs.

Documentation

• Chinese README
• MCP server
• Project strategy
• Roadmap
• Changelog

License

MIT