Smidge Documentation

Smidge turns your source materials — docs, videos, PDFs, URLs — into SKILL.md files that teach AI coding agents your domain expertise. Upload your content, and Smidge handles the rest.

What are Agent Skills?

Agent Skills are structured knowledge files that AI coding agents can read and act on. Think of them as curriculum for your AI — teaching it how to work with specific frameworks, follow your brand voice, enforce coding standards, or execute specialized tasks.

Skills generated by Smidge work across all major AI coding platforms out of the box. Use the CLI to install them in one command, or download them directly from your library.

How Smidge Works

Smidge transforms your source materials into well-structured skills in three steps:

Step 1: Ingest

Your source materials are parsed and cleaned. PDFs are extracted, audio is transcribed, YouTube transcripts are fetched, and web pages are scraped. Multiple sources are combined and prepared for generation.

Step 2: Generate

Smidge analyzes the content and structures it into a skill — complete with principles, examples, guidelines, and context — ready for any AI coding agent to consume.

Step 3: Ship

Your skill is saved to your library, ready for one-command install to any platform. Large skills are automatically organized so they stay performant across all agents.

Skill Catalogues

When Smidge detects multiple distinct topics in your source material — or you upload several large files — it offers to generate a Skill Catalogue: a structured set of individual skills, each focused on one topic, plus a master index SKILL.md that routes between them.

Each topic in a catalogue costs 1 credit. You can select which topics to include, merge everything into a single skill, or let Smidge generate the full catalogue automatically. Install an entire catalogue with one CLI command:

smdg install <catalogue-id> --all

Supported Platforms

SKILL.md is an open standard supported by 30+ AI agents. Skills generated by Smidge work with all of them. Here are the major platforms:

Tier 1 — Direct Install Support

• ●Claude Code — Install to ~/.claude/skills/ or project-level .claude/skills/
• ●Claude.ai — Add skills directly in Claude.ai project settings
• ●Cursor — Install to ~/.cursor/skills/ or project-level .cursor/skills/
• ●OpenAI Codex CLI — Install to ~/.codex/skills/ or project-level .codex/skills/
• ●GitHub Copilot — Reads skills from .github/skills/ in your repository
• ●Gemini CLI — Install to ~/.gemini/skills/ or project-level .gemini/skills/

Tier 2 — Compatible Agents

These agents support the SKILL.md format via filesystem or tool-based discovery:

• ●VS Code — via GitHub Copilot or extensions
• ●Windsurf — Codeium's AI IDE
• ●Zed — Zed editor's built-in agent
• ●Continue — Open-source AI code assistant
• ●Cline — Open-source coding agent
• ●Roo Code — AI coding agent
• ●Goose — Block's open-source agent
• ●Amp — Sourcegraph's coding agent
• ●ChatGPT — Upload as a file attachment or paste into system prompt

Use It Anywhere

Smidge works however you work. Use the web app to generate interactively, the CLI to generate from your terminal, or the REST API to integrate skill generation into your own tools and workflows.

Quick Links