The smeltery skill library
Good agents.
Better instincts.
Give your coding agent a proven way to work.
Practical skills for the thinking, building, and shipping.
Small files.
Real improvements.
A skill for the next step
What are you working on?
Start with the outcome.
Find the workflow that gets you there.
diagnose
Disciplined diagnosis loop for hard bugs and performance regressions.
tdd
Test-driven development with red-green-refactor loop.
review
Review a pull request or local change set end-to-end in read-only mode by using the stated scope, associated ticket context when available, full diff context, and relevant tests.
design
Writes a clear design for a proposed feature or system change.
zoom-out
Tell the agent to zoom out and give broader context or a higher-level perspective.
workon
Pick up a Linear ticket end-to-end — worktree, implement, PR, then watch the PR on a 5-min loop addressing reviewer comments (Codex, CodeRabbit), CI failures, and merge conflicts until merged.
simplify
Simplify a finished code change for human review without changing behavior.
architecture
Create or update root ARCHITECTURE.md from verified implementation.
handoff
Compact the current conversation into a handoff document for another agent to pick up.
verify
Proves that a code change meets its acceptance criteria.
wayfinder
Plan work too large or unclear for one agent session by creating a shared issue-tracker map, breaking uncertainty into decision tickets, and working one frontier ticket at a time until the path is clear.
unslop
Edit writing to strip out AI-generated tells and put a real voice back in.
architecture-review
Reviews a technical proposal before implementation.
branch-conventions
Provides conventional-commit branch-name prefixes (feat/, fix/, chore/) and the standard flow for creating a branch from the up-to-date default branch.
caveman
Ultra-compressed communication mode.
ci-monitoring
Watches GitHub PR checks and handles CI failures — reruns failed jobs, ignores the approval-requirements check, and confirms PR readiness once all required checks are green.
cloud-factory
Convert the current GitHub repository into a cloud software factory by installing agent skills, docs, labels, specs directories, and GitHub Actions workflow templates.
commit-conventions
Formats commits as conventional commits and matches commit-message type (feat:, fix:, chore:) to branch intent, appending optional issue references.
feature-gap
Compare an upstream/source GitHub repository against a destination repository, identify real missing feature gaps, implement them cleanly in the destination repo, then commit and push to the destination main branch.
gho
Prefers the `gho` CLI (smeltery/gho) over `gh` for GitHub operations — pull requests, issues, releases, labels, repos, search, and Actions runs/workflows — since every `gho` response is TOON output with a definitive total and a `help[]` block naming the next command.
git-commit
Commits staged files using a temp-file commit message to avoid shell-substitution pitfalls.
git-safety
Guards against destructive git operations — prefers stash + cherry-pick over rebase, restricts force pushes to `--force-with-lease`, and avoids `reset --hard` and `clean -fd`.
grill-me
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree.
grill-with-docs
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise.
html-doc
Generates a polished, static HTML reading view from an existing Markdown PRD or technical design.
improve-codebase-architecture
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/.
lean-diff
Keep the net diff as small as possible whenever code is written, edited, or refactored — minimal targeted changes over rewrites, no drive-by reformatting or renaming, no unrequested abstractions, and a git diff review before calling any code change done.
linear
Use the `linear` CLI to search Linear, inspect issues, manage comments, list workspace metadata, and check Linear platform status.
loc-budget
Find large line-count hitters in a repository, modularize them into smaller cohesive files, and add or tighten file-size and flat-directory budget CI gates.
performance-engineer
Measure, diagnose, and improve software performance on a specific critical path.
port
Port an upstream GitHub repository into a fresh private destination repository with a new identity, clean initial history, detailed docs, CI/pre-commit/Flox setup, structure cleanup, and upstream-reference sanitization.
pr-monitor
Monitors a GitHub pull request for AI review comments, CI failures across every provider reporting on the PR, and merge-readiness signals; applies scoped fixes, responds to bot threads, and stops once the merge bar is met.
pr-workflow
Creates and manages pull requests — pushes the branch, writes a reviewer-focused description (why + how to verify), names the PR to match branch intent, and checks mergeability.
prototype
Build a throwaway prototype to flush out a design before committing to it.
taste-review
Get an independent, taste-driven judgment on an ambiguous choice such as UI polish, prose, naming, or formatting, then weigh and apply the recommendation when authorized.
teach
Teach the user a new skill or concept, within this workspace.
to-issues
Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices.
to-prd
Turn the current conversation context into a PRD and publish it to the project issue tracker.
track-my-work
Pulls your recent Linear and GitHub activity into a personal Notion Standup Log database.
triage
Triage issues through a state machine driven by triage roles.
ui-studio
Use Playwright CLI, Paper MCP, Refero research, optional ui.sh polishing skills, runnable repository UIs, curated design links, and visual references to create an original named reusable UI kit and hostable showcase through a resumable gated workflow.
web-search
Search the internet with Google or DuckDuckGo, inspect results, and extract selected pages as readable Markdown.
website-studio
Design, implement, and verify a complete polished website from a brief, an empty directory, or an existing repository.
workon-event
Event-driven ticket driver — receives a single event (ticket-ready, PR comment, CI failure, base advanced, merge, close, convergence check) and dispatches to the matching handler.
worktree
Prefers the `wt` CLI (smeltery/worktree) over raw `git worktree` plumbing for creating, listing, opening, cleaning up, and removing worktrees.
wrap
Wraps an AI coding session — classifies completion, persists resume state before prompting the user, writes durable memory (episodes, reflections, insights), surfaces anti-sycophantic highlights, and audits where the agent paused for the user (autonomy blocker buckets).
wrap-resume
Reads resume-state from plan files written by /wrap and presents a picker for continuing prior sessions.
write-a-skill
Create new agent skills with proper structure, progressive disclosure, and bundled resources.
From discovery to doing
Three steps. Then it’s yours.
- 01
Find your starting point.
Pick a skill for the work in front of you. A stubborn bug, a new idea, or a diff that needs another look.
- 02
Make it available.
Copy the install command. Choose your agent in the installer, and add the skill to your project.
- 03
Put it to work.
Ask your agent to use the skill. It follows the workflow, and you stay in control of the result.