skills
Agent skills for engineers who won't lower their standards to use AI.
35 skills I built for my own work and use every day, open source. Install the set, or take only the ones you want.
- skills
- 35skills
- plugins
- 16plugins
- licensed
- MITlicensed
- agents
- 2agents
Install my skills
Installed as plugins from one marketplace. Add it once, then install the plugins you want.
Any agent — pick the skills and agents you use. The installer writes editable files into your project.
npx skills@latest add smorinlabs/smorinlabs-skillsClaude Code — add the marketplace.
/plugin marketplace add smorinlabs/smorinlabs-skillsThen install a plugin.
/plugin install repo-hygiene@smorinlabs-skillsCodex — clone the repo, then register it in ~/.codex/config.toml.
git clone https://github.com/smorinlabs/smorinlabs-skills.gitThen register it in the config.
[marketplaces.smorinlabs-skills]
source_type = "local"
source = "/absolute/path/to/smorinlabs-skills"Source: smorinlabs/smorinlabs-skills
On this page
What a skill actually is
The problem
An agent will happily do the work the wrong way — skip the tests, guess at the API, commit straight to main — and sound confident doing it.
The fix
A skill is a written procedure the agent loads when it matches the work. Not a prompt you paste: a file the agent finds on its own, at the moment it applies.
What you type
A slash command, or nothing at all. Most of these fire on their own when the task fits, which is the point — you should not have to remember they exist.
Start here
Eight that earn their place on the first day.
The set
All 35, grouped by what you reached for them to do.
Nothing matches that search.
Shape the work
Turn a vague idea into decisions and tasks you can actually start.
8 skills
start with /question-walkthrough
- /question-walkthroughDecide a pile of open questions one at a time.Takes an unresolved pile — open questions in a doc, undecided to-dos, a plan blocked on four things nobody has answered — and turns it into a sequence of single decisions.
- /project-addCapture an idea in four questions, then stop.Registers a new project on the PROJECTS.md trunk: at most four questions, asked one at a time, then an idea stub and a trunk row written in a single atomic commit.
- /project-refineScope an idea up to ready, or break it into tasks.Three sub-modes over one project: refine its notes and references, scope a raw idea until it is genuinely startable, or decompose a scoped project into tasks.
- /project-nextAnswer "what should I work on?" from the actual trunk.Reads PROJECTS.md and projects/ and builds a composite menu: what is in progress, the next few unstarted projects by ID, and the files touched most recently.
- /project-auditEleven drift checks against your project tracking.Dispatches one auditor per check in parallel against PROJECTS.md and projects/, then walks the findings with you one at a time and asks before fixing anything.
- /using-project-harnessBootstraps the project skills on first use in a repo.Establishes the five project-harness skills in a repo, runs a four-step idempotent setup the first time, and routes any edit of project state to whichever sibling owns it.
- /guided-researchDeep research at the moments that actually justify it.An orchestration layer over deep research that decides when the expensive version is worth running — architectural decisions, new problem domains with established best practice, unfamiliar APIs you have already failed against twice — then organizes what comes back so it is reusable rather than read once.
- /design-by-elementsPrototype the form of an artifact before you build it.Decomposes an artifact — terminal output, a report layout, a table design, a page or email mockup, a status block — into elements, then iterates on each one in isolation before assembling.
Work the code
Review, refactor, and consolidate what is already written.
4 skills
start with /factor-scan
- /factor-scanSweep a code area for bugs, smells, and architectural drift.A broad sweep over an area of code that surfaces three different classes of problem at once — outright bugs, quality issues, and architectural smells — then walks you through the findings one at a time rather than dumping a report.
- /factor-architectArchitectural review against precedent and convention.Reviews a design against the codebase's own precedent, its stated conventions, and external references for the pattern in question.
- /factor-dedupConsolidate N implementations of the same idea.Walks per-implementation comparator reports across several similar implementations, classifies every divergence as intentional or accidental, and proposes a unified design — or documents why a divergence should survive.
- /using-factor-harnessRoute to the right one of the three factor skills.Orients across the factor-harness set and picks the right entry point for what you are actually doing.
- /pr-merge-flowDrive an open PR to merge, resolving every thread.Waits (with a bound) for the AI reviewer bots to weigh in, then triages every review thread: verifies claims by running the code where it can, fixes small in-scope bugs, defers out-of-scope work to the tracker, declines style-only asks, and escalates genuine redesigns to you.
- /version-checkIs this version consistent, and is it published?Inspects and compares the versions a project claims across its manifest, its tags, and its registry, and reports where they disagree.
- /readme-syncDoes the README still describe the code?Verifies README.md against the current state of the project and updates it where it has drifted.
- /manual-test-guideThe commands to run to check this by hand.Produces concrete manual testing instructions for a project — what to run, what to look at, what counts as working.
- /fusion-runner-runStart, inspect, and gracefully stop a Windows CI runner on your Mac.Operates an existing Windows virtual machine in VMware Fusion that serves as a GitHub Actions runner.
- /fusion-runner-setupSet up a Windows GitHub Actions runner in VMware Fusion.Guides installation of Fusion and Windows on an Apple Silicon or Intel Mac, provisions the tools needed by the intended workflows, and registers a GitHub Actions runner service.
- /ci-fixFind the cause of red CI checks and verify the repair.Diagnoses failing GitHub Actions and Git hooks, reproduces the relevant failure, and verifies affected behavior before pushing a repair.
- /muse-github-setupAdd Muse Spark PR reviews to a GitHub repository.Installs or updates the OpenCode GitHub Action with Meta Muse Spark, so organization members get automatic PR feedback and, optionally, fix PRs they request by hand.
- /dependabot-sweepClear the Dependabot backlog across every repo you own.Sweeps every open Dependabot PR across the orgs or repos in a TOML config and drives each one toward merge through bounded per-repository workers.
- /explainExplanations anchored to a real example, every time.A fixed anatomy for explaining anything: what it is, just enough context to place it, and always a concrete example rather than a description of one.
- /html-codesignA decision page someone can operate and send back.Builds a single self-contained HTML file that turns a decision into something a person can operate: a step-through wizard, one question per screen, each with context and an argued recommendation.
- /clear-technical-communicationRewrite technical prose so the reader infers nothing.Reviews and rewrites technical communication against one rule: minimize what the reader has to reconstruct.
- /use-html-themePick a visual theme, apply it consistently.Offers a small catalog of visual themes whenever HTML is being generated or restyled, and applies the chosen one coherently across the page.
- /reader-stepsFormat the steps only a human can perform.A style spec for rendering actions the reader has to do themselves — interactive logins, UI clicks, approvals in other systems — as a bounded task block: numbered with a stable tag, grouped by surface (terminal, browser, phone, physical world), each step titled by its outcome with the literal command underneath and a verification line.
- /document-mergeMerge overlapping docs without losing a line.Consolidates several overlapping markdown documents into one, verifiably: every synthesis decision gets a stable ID, every source line range maps to an output section, the originals are archived byte-identical, and a validation script enforces the round trip.
- /html-explainAn explainer page where prose alone would not do.A read-only page for settled material, where diagrams, annotated figures, charts, and small interactive widgets do work prose cannot.
- /clear-decision-communicationAsk for a decision with the context needed to make it.Prepares a decision request while an agent works: checks whether approval is actually needed, investigates what can be resolved, and presents the options, recommendation, evidence, and exact action an answer authorizes.
Run the session
Orient, hand off, and clean up the agent sessions themselves.
6 skills
start with /session-recap
- /session-recapCatch yourself up on a session gone cold.Reconstructs a session you have lost the thread of: what it was about, where it started and ended, what is done versus open, the live state of git, the PR, and the worktree — then ranks what to do next and ends with a verdict on whether to close it or carry on.
- /session-statusA "you are here" map of work still in flight.A mid-flight progress check on the active stream of work, in plain language: what the work is, what is done, what is in progress, what is left — scaled to the shape of the work rather than a fixed template.
- /session-handoffPackage a session so a cold one can continue it.Packages the current session into something a zero-context session — often on another machine — can act on cold: the outcome being pursued, full repo identity and paths, the resume state, and the tacit context that dies on compaction.
- /session-loose-endsFind what a session left dangling, and clean it up.Sweeps for four classes of loose end — uncommitted work and stale worktrees, running or zombie processes, promises made in conversation but never kept, and project-tracking drift — then reports each with its evidence and a recommendation in both directions before doing anything.
- /session-agent-listEvery agent session on this machine, as action cards.Finds Claude Code and Codex sessions across the machine and renders them as action-ready cards: how long ago, whether each is open mid-work or handed off or closed cleanly, what it was doing, and which repos and worktrees it touched.
- /repo-finderResolve a repo name to its real path in one command.Turns a bare repo name into every local copy plus the facts you need about each: origin, default branch, whether it is a checkout or a worktree, current branch, dirty state, build tooling.
What changed recently
The last five releases.
- v0.32.0Sep 28, 2026
The repository moved from smorinlabs/smorinlabs-harness to smorinlabs/smorinlabs-skills, and the marketplace name changed to match
Every plugin id changes from <plugin>@smorinlabs-harness to <plugin>@smorinlabs-skills. Old GitHub URLs redirect.
- v0.31.1Sep 28, 2026
clear-decision-communication 0.5.0 -> 0.7.1: decision briefs now ground the reader from the situation, through the moving parts, down to evidence
They say whether a question is substantive or about process, and a process question names the substantive question underneath it. A new F22 process view shows what waits on what. At T2 and above every option states its cost and reversal, and a runner-up line says when the strongest alternative wins (#89).
- v0.31.0Sep 27, 2026
repo-hygiene 0.17.0 adds a durable Dependabot sweep core and CLI with saved run state, repository worker leases, bounded dispatch, and crash recovery
- v0.30.0Sep 26, 2026
session 0.12.0: session-status draws an ASCII kanban board of what's left when work runs in parallel, five or more items remain, or stated dependencies decide the order
Columns follow the plan's own status words, defaulting to NOW / NEXT / LATER / BLOCKED; parallel work renders as swimlanes, and done work stays one rolled-up line.
- v0.29.0Sep 22, 2026
Shared skill references now resolve under symlinked placements, bare per-skill copies, and lexical path computation across 9 plugins (34 skills): cites are spelled relative to the citing file, 11 skills gain a "Resolving shared references" section, and copied artifacts carry destination tests
Minor: project-harness 0.2.0, factor-harness 0.2.0, use-html-theme 0.12.0. Patch: fusion-runner 0.3.1, document-merge 0.1.3, repo-hygiene 0.16.1, clear-decision-communication 0.3.2, clear-technical-communication 0.2.4, muse-github 0.1.1.
Also recommended
Not mine. Installed anyway, on most machines I work on.
Stops the guessing loop where an agent describes what it changed instead of showing you.
Turns the instruction file you keep meaning to tidy into something that actually steers behavior.
Maps a foggy piece of work into decision tickets, so planning stops being one long conversation.
Setup flows that ask rather than assume — the pattern most install skills should have copied.
Structural, syntax-aware code search and rewriting. The right tool the moment a regex refactor starts feeling brave.
Audits code for security vulnerabilities, with independent agents checking each finding against the source before it reaches the report.
Create, improve, and evaluate skills — including measuring whether a description actually triggers.
The methodology layer underneath everything else: brainstorming, planning, TDD, systematic debugging.
A second model family as an independent lens — adversarial review from something that is not Claude.
Skills for your next iOS or Mac app
Explore skills, plugins, and tools for SwiftUI, testing, debugging, and App Store workflows. Includes setup notes, Apple documentation options, and articles from the developers behind them.
34 resources · 6 topics · 7 articles
Explore the iOS & Mac collection- SwiftUI
- Xcode
- Apple docs
- App Store
Install my skills and get to work
MIT licensed, one repo, no account. Take the whole set or one plugin.
Add the marketplace.
/plugin marketplace add smorinlabs/smorinlabs-skillsThen install a plugin.
/plugin install repo-hygiene@smorinlabs-skills