# Smeltery Skills

> Portable workflows for coding agents. Read a skill, install it, and apply its instructions to your task.

Install: npx skills@latest add smeltery/skills

This is a public documentation library, not a hosted agent service. No account, payment, API key, or MCP connection is required. The source is licensed under PolyForm Shield; see https://github.com/smeltery/skills/blob/main/LICENSE for terms.

## When to use
Use diagnose for investigating bugs, tdd for test-first implementation, design for planning, review for reviewing changes, and handoff for transferring work. Read the chosen skill before invoking it. Do not use this site as a hosted execution service.

## Guides
- [Installation](https://smeltery-skills.vercel.app/guides/installation/): Install and invoke skills.
- [Approach](https://smeltery-skills.vercel.app/guides/approach/): Why these workflows exist.
- [Full text](https://smeltery-skills.vercel.app/llms-full.txt): All skill instructions in one document.
- [Brand](https://smeltery-skills.vercel.app/brand/): Brand assets and usage.

## Skills
- [architecture](https://smeltery-skills.vercel.app/skills/architecture/): Create or update root ARCHITECTURE.md from verified implementation.
- [architecture-review](https://smeltery-skills.vercel.app/skills/architecture-review/): Reviews a technical proposal before implementation.
- [branch-conventions](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/caveman/): Ultra-compressed communication mode.
- [ci-monitoring](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/commit-conventions/): Formats commits as conventional commits and matches commit-message type (feat:, fix:, chore:) to branch intent, appending optional issue references.
- [design](https://smeltery-skills.vercel.app/skills/design/): Writes a clear design for a proposed feature or system change.
- [diagnose](https://smeltery-skills.vercel.app/skills/diagnose/): Disciplined diagnosis loop for hard bugs and performance regressions.
- [feature-gap](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/git-commit/): Commits staged files using a temp-file commit message to avoid shell-substitution pitfalls.
- [git-safety](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/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.
- [handoff](https://smeltery-skills.vercel.app/skills/handoff/): Compact the current conversation into a handoff document for another agent to pick up.
- [html-doc](https://smeltery-skills.vercel.app/skills/html-doc/): Generates a polished, static HTML reading view from an existing Markdown PRD or technical design.
- [improve-codebase-architecture](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/linear/): Use the `linear` CLI to search Linear, inspect issues, manage comments, list workspace metadata, and check Linear platform status.
- [loc-budget](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/performance-engineer/): Measure, diagnose, and improve software performance on a specific critical path.
- [port](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/prototype/): Build a throwaway prototype to flush out a design before committing to it.
- [review](https://smeltery-skills.vercel.app/skills/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.
- [simplify](https://smeltery-skills.vercel.app/skills/simplify/): Simplify a finished code change for human review without changing behavior.
- [taste-review](https://smeltery-skills.vercel.app/skills/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.
- [tdd](https://smeltery-skills.vercel.app/skills/tdd/): Test-driven development with red-green-refactor loop.
- [teach](https://smeltery-skills.vercel.app/skills/teach/): Teach the user a new skill or concept, within this workspace.
- [to-issues](https://smeltery-skills.vercel.app/skills/to-issues/): Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices.
- [to-prd](https://smeltery-skills.vercel.app/skills/to-prd/): Turn the current conversation context into a PRD and publish it to the project issue tracker.
- [track-my-work](https://smeltery-skills.vercel.app/skills/track-my-work/): Pulls your recent Linear and GitHub activity into a personal Notion Standup Log database.
- [triage](https://smeltery-skills.vercel.app/skills/triage/): Triage issues through a state machine driven by triage roles.
- [ui-studio](https://smeltery-skills.vercel.app/skills/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.
- [unslop](https://smeltery-skills.vercel.app/skills/unslop/): Edit writing to strip out AI-generated tells and put a real voice back in.
- [verify](https://smeltery-skills.vercel.app/skills/verify/): Proves that a code change meets its acceptance criteria.
- [wayfinder](https://smeltery-skills.vercel.app/skills/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.
- [web-search](https://smeltery-skills.vercel.app/skills/web-search/): Search the internet with Google or DuckDuckGo, inspect results, and extract selected pages as readable Markdown.
- [website-studio](https://smeltery-skills.vercel.app/skills/website-studio/): Design, implement, and verify a complete polished website from a brief, an empty directory, or an existing repository.
- [workon](https://smeltery-skills.vercel.app/skills/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.
- [workon-event](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/worktree/): Prefers the `wt` CLI (smeltery/worktree) over raw `git worktree` plumbing for creating, listing, opening, cleaning up, and removing worktrees.
- [wrap](https://smeltery-skills.vercel.app/skills/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](https://smeltery-skills.vercel.app/skills/wrap-resume/): Reads resume-state from plan files written by /wrap and presents a picker for continuing prior sessions.
- [write-a-skill](https://smeltery-skills.vercel.app/skills/write-a-skill/): Create new agent skills with proper structure, progressive disclosure, and bundled resources.
- [zoom-out](https://smeltery-skills.vercel.app/skills/zoom-out/): Tell the agent to zoom out and give broader context or a higher-level perspective.