Quick Start
This guide walks you through generating your first skill using the Smidge web app. The entire process takes under 2 minutes.
Web App
Sign up for an account
Head to smdg.app/login and sign up with GitHub, Google, or a magic link email. You'll get 2 free credits immediately — no credit card required.
Upload your source materials
Drag and drop files or paste URLs into the upload area. Accepted formats include PDF, DOCX, audio files, YouTube URLs, web pages, and more.
You can upload multiple sources — Smidge will fuse them into a single cohesive skill.
Configure your skill
Give your skill a name, description, and category. Smidge will attempt to prefill these from your source content. Choose a skill type:
- •Coding — for frameworks, libraries, architecture patterns
- •Writing — for brand voice, style guides, content standards
- •Task — for checklists, review processes, workflows
Generate
Hit Generate and watch the three-pass pipeline work in real time. You'll see extraction, synthesis, and validation progress as Server-Sent Events stream in.
When complete, the skill is validated against the Agent Skills spec. Any warnings are shown alongside the result.
Install your skill
Download the SKILL.md file (or zip if it includes references) and copy it to your agent's skills directory:
- •Claude Code:
~/.claude/skills/ - •Cursor:
~/.cursor/skills/ - •Codex CLI:
~/.codex/skills/ - •GitHub Copilot:
.github/skills/ - •Gemini CLI:
~/.gemini/skills/
Or use the CLI: smdg install --platform claude
CLI Quick Start
Prefer the command line? Generate a skill in three commands:
# Install the CLI globally
npm install -g smdg
# Authenticate with your Smidge account
smdg login
# Generate a skill from a local file
smdg generate --source ./my-docs.pdf --name my-skill
# Or from a YouTube video
smdg generate --source "https://youtube.com/watch?v=..." --name yt-skill
# Install directly to your platform
smdg generate --source ./guide.pdf --name my-guide --install claude
smdg generate --source ./guide.pdf --name my-guide --install cursorsmdg generate --source doc.pdf --source "https://youtube.com/..."