Smidge Documentation

Smidge generates SKILL.md files — structured knowledge packages that teach AI coding agents domain expertise. Upload your source materials, and Smidge transforms them into a validated, spec-compliant skill that works across all major AI coding platforms.

What are Agent Skills?

Agent Skills are an open standard for packaging instructions, guidelines, and examples into files that AI coding agents can consume. 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.

Each skill is a SKILL.md file (or a directory containing one) with YAML frontmatter and structured markdown sections. When loaded by a compatible agent, the skill becomes part of the agent's working knowledge.

How Smidge Works

Smidge uses a three-pass AI pipeline to transform raw source materials into well-structured skills:

Pass 1: Extract

Source materials are parsed and converted into clean text. PDFs are extracted, audio is transcribed via Whisper, YouTube transcripts are pulled, and web pages are scraped and cleaned. Multiple sources are concatenated with clear boundaries.

Pass 2: Synthesize

The extracted content is analyzed and restructured into the SKILL.md format. The AI identifies key instructions, generates examples with input/output pairs, extracts guidelines, and ensures imperative voice throughout.

Pass 3: Validate & Refine

The generated skill is validated against the Agent Skills specification — checking frontmatter, structure, word count, voice, and formatting. Any issues are automatically corrected in a refinement pass.

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

Quick Links