Skip to content

jaydubya818/software-factory-skills

v2.6.0

Cross-harness delivery, review, Agent-Native, visual, and software-factory skills for production work.

adr-verbatim

Record approved decisions as concise architecture decision records.

agent-watchdog

Audit, monitor, compare, or repair another agent's session or PR when asked.

an

Operate granted Agent-Native apps through Dispatch MCP; use for /an.

api-and-interface-design

Design API contracts, compatibility, and duplicate-safe mutations.

architect

Use when a non-trivial change needs types and module boundaries designed before code.

arena

Use when an important artifact needs independent solutions compared and synthesized.

automate-me

Use when the user wants working preferences captured in a reusable mode skill.

babysit

Use when an authorized pull request needs ongoing CI and review follow-through.

before-and-after

Use when attaching screenshots or recordings to a GitHub PR.

benchmark-checklist

Use when checking measured benchmark claims.

blast-radius

Use when a change needs downstream risks traced and its key safety assumption proved.

bro

Use when the previous technical answer needs a direct, jargon-free restatement.

ci-cd-and-automation

Create or change CI/CD pipelines, quality gates, and delivery controls.

code-structure

Separate orchestration from shared mechanics while preserving transactions.

correct

Use for /correct or requested fixes to repeated agent mistakes.

create-formal-verification-skill

Use when creating a project-local formal verifier.

create-readonly-db-role

Prepare least-privilege PostgreSQL agent access when requested.

create-verification-skill

Use when a repository needs a repeatable driver that proves real UI, CLI, or service behavior.

deprecation-and-migration

Retire APIs or migrate consumers and persistent data across releases.

deslop

Use when code needs generated clutter removed and structure simplified without behavior changes.

efficient-fable

Delegate bounded independent work while Claude Fable retains judgment.

efficient-frontier

Delegate costly independent work while a frontier model retains judgment.

evidence-driven-testing

Capture runtime evidence with video, screenshots, or measured output.

factory

Configure governed delivery sources, schedules, isolation, and action gates.

factory-babysit-pr

Monitor one authorized PR with separate fix, publish, reply, and merge gates.

factory-collect

Triage configured product signals under separate fix, reply, and close policies.

factory-human-digest

Read-only summary of configured work needing human decisions.

factory-lookback

Audit signal history for recurring problems and systemic fixes.

factory-recover

Resume eligible interrupted runs without repeating completed actions.

factory-review-prs

Triage PR queues under separate reply, approval, and merge gates.

factory-ship

Ship authorized work under separate publish, merge, deploy, and notification gates.

factory-watchdog

Monitor authorized delivery tasks for verified stalls.

figure-it-out

Use when novel or multi-phase work needs an auditable workflow and no narrower playbook fits.

fix-ci

Use when failing pull-request checks need a root-cause fix and a verified rerun.

fix-merge-conflicts

Use when a branch needs conflicts resolved and the merged result verified.

frontend-ui-engineering

Build complete, accessible UI flows with explicit states and browser checks.

get-pr-comments

Use when pull-request feedback needs to be fetched and summarized for action.

greploop

Run bounded Greptile review-and-fix cycles on a PR, MR, or shelved change. Use when Greptile is an explicit delivery gate.

greploop-apps

Run greploop through @greptile-apps when the normal trigger rejects a large PR. Use only with the companion greploop skill.

handoff

Write verified session context when asked to hand work to another agent.

how

Use for runtime, ownership, layering, code-walkthrough, and placement questions.

in-your-own-words

Use when asked to restate the user's goal.

interrogate

Use when a change's assumptions, evidence, or design need adversarial review.

ketchup

Use for /ketchup or a chat progress catch-up.

maintain-formal-verification-skill

Use when refreshing a project's formal verification.

maintain-verification-skill

Use when a project's verification driver or feature map may be stale.

make-pr-easy-to-review

Use when a correct pull request needs clearer history, description, or reviewer guidance.

mission-control-delivery

Preserve evidence and authority when Mission Control governs delivery.

new-feature

Isolate repository edits in a task-owned Git worktree. Skip read-only work.

no-comments

Use when code comments need structural review, root-cause fixes, and constraint encoding.

observability-and-instrumentation

Add or review logs, metrics, traces, and actionable alerts.

performance-optimization

Investigate slow paths and optimize measured bottlenecks.

plan-arbiter

Compare, judge, or combine competing plans into one executable path.

plow-ahead

Proceed through routine ambiguity when autonomous progress is requested.

poteto-help

Use for help choosing or using Jstack workflows.

poteto-mode

Use when non-trivial work should follow the smallest rigorous Jstack workflow.

principle-attack-the-premise

Apply when repeated fixes fail and a shared assumption may be wrong.

principle-boundary-discipline

Apply when validation or adapters leak from external boundaries into core logic.

principle-build-the-lever

Apply when a rerunnable script, codemod, generator, or check makes work auditable.

principle-encode-lessons-in-structure

Apply when a repeated instruction should become enforceable in tests, lint, metadata, or tools.

principle-exhaust-the-design-space

Apply when a novel design needs concrete candidates compared before selection.

principle-experience-first

Apply when scope threatens a polished, clear, and trustworthy user experience.

principle-explain-the-number

Apply when a measured result needs its limits explained.

principle-fix-root-causes

Apply when a workaround would hide a defect that can be reproduced and traced.

principle-foundational-thinking

Apply when core types, data structures, or shared-state boundaries will shape the system.

principle-guard-the-context-window

Apply when large files, logs, or broad exploration threaten reasoning focus.

principle-laziness-protocol

Apply when a refactor is adding wrappers or abstractions instead of simplifying.

principle-make-operations-idempotent

Apply when an operation must tolerate retries after partial completion.

principle-migrate-callers-then-delete-legacy-apis

Apply when replacing an internal API without leaving ambiguous dual paths.

principle-minimize-reader-load

Apply when layers, wrappers, or hidden state make simple behavior hard to follow.

principle-model-the-domain

Apply when repeated state conditionals reveal a missing domain model.

principle-never-block-on-the-human

Apply when safe reversible implementation details can proceed inside scope.

principle-outcome-oriented-execution

Apply when a bounded rewrite should converge without throwaway compatibility layers.

principle-prove-it-works

Apply when the actual candidate and observable result still need verification.

principle-redesign-from-first-principles

Apply when a requirement breaks a foundational assumption and needs coherent redesign.

principle-separate-before-serializing-shared-state

Apply when concurrent actors share mutable files, branches, keys, or objects.

principle-sequence-verifiable-units

Apply when multi-step work must end each ordered unit in a verified state.

principle-subtract-before-you-add

Apply when new work would otherwise build on dead or redundant structure.

principle-test-behavior-not-implementation

Apply when tests mirror internals instead of asserting observable outcomes.

principle-type-system-discipline

Apply when typed APIs or schemas should make invalid states unrepresentable.

prompt-for-others

Write a verified setup or fix prompt for a teammate's agent on request.

quick-recap

Use a red, yellow, or green status line for compact agent completion reports.

read-the-damn-docs

Read primary docs for external APIs, packages, or high-stakes behavior.

recall

Use when resuming work or reconstructing project context from workspace-scoped history.

reflect

Use when approved session lessons should become durable workflow improvements.

rewind

Retrieve local Clips Rewind context for something the user recently saw or said.

risky-changes

Validate assumptions behind changes to billing, API data, or defaults.

security-and-hardening

Review security or harden sensitive trust boundaries with abuse-case tests.

setup-jstack

Use when the user wants to configure Jstack's per-role Claude models.

sharpen

Use for /sharpen to clarify a task before work.

show-me-your-work

Use when long-running work needs an auditable decision and evidence log.

stay-within-limits

Check host usage limits between bounded waves of long-running work.

swarm

Use when authorized independent workers can run without shared mutable state.

tdd

Use when TDD is requested or a bug has a cheap, direct regression target.

teach

Use when runtime behavior and design rationale should become one clear mental model.

technical-writing

Use when docs, RFCs, READMEs, PRs, or commits need structured and direct prose.

thermo-nuclear-code-quality-review

Use when the user requests an intentionally strict maintainability review.

thermo-nuclear-review

Use for a deep security and correctness diff review.

thermos

Use for combined correctness and code-quality reviews.

turn-into-app

Build a verified Agent-Native app from a workflow, skill, or visible artifact.

typescript-best-practices

Use when TypeScript needs focused type-safety, API, or error-handling guidance.

unslop

Remove filler and generic AI phrasing from human-facing text. Use before sending or committing prose you edited.

visual-edit

Edit or review a running local app through Agent-Native Design.

visual-plan

Create an interactive Agent-Native plan for visual review.

visual-recap

Create an Agent-Native visual recap from a substantial code change.

webmcp

Operate a web app through its page MCP tools; use for /webmcp.

what-did-i-get-done

Use when authored work needs a concise summary for a concrete time window.

why

Use when design rationale must be recovered from source history and available records.