{ "skills": [ { "name": "agent-notepad", "description": "Persistent, per-objective working memory for coding agents — one standalone git \"notepad\" repo per objective that survives context compaction, spans multiple code repos from a single session, keeps an append-only journal, and mirrors into an episodic memory index. Ships as a Claude Code plugin (hooks + skills + notepad template + a memory adapter). Evolves and supersedes handoff-auto. Use when setting up objective-scoped agent memory, running several long-lived concurrent agent sessions, surviving auto-compaction, enabling `/clear` instead of `/compact`, driving several code repos from one place without `cd`, or installing/uninstalling the notepad hooks. Triggers on \"agent notepad\", \"working memory notepad\", \"per-objective memory\", \"scope-init\", \"survive compaction\", \"cross-repo agent memory\", \"supersede handoff-auto\".", "files": [ "DESIGN.md", "SKILL.md", "plugin/.claude-plugin/plugin.json", "plugin/notepad-template/.claude/settings.json", "plugin/notepad-template/CLAUDE.md", "plugin/notepad-template/DIGEST.md", "plugin/notepad-template/NOTES.md", "plugin/notepad-template/SCOPE.md", "plugin/notepad-template/org-routing.example.json", "plugin/notepad-template/repos.manifest.json", "plugin/notepad-template/sessions/index.json", "plugin/skills/handoff/SKILL.md", "plugin/skills/scope-init/SKILL.md", "plugin/skills/scope-retire/SKILL.md" ] }, { "name": "architecture-reviewer", "description": "Review architectural changes for coupling, blast radius, and long-term impact. Use when evaluating system design changes, cross-service dependencies, API changes, or infrastructure modifications. Triggers on \"architecture review\", \"impact analysis\", \"blast radius\", \"coupling review\", \"dependency analysis\", \"breaking change\", \"migration review\", \"system design review\".", "files": [ "CHECKLIST.md", "PATTERNS.md", "SKILL.md" ] }, { "name": "backend-service-auditor", "description": "Audit backend services for security, reliability, performance, and operability issues. Use when reviewing APIs, microservices, workers, or backend code changes. Triggers on \"audit backend\", \"security review\", \"service audit\", \"API audit\", \"check vulnerabilities\", \"review microservice\", \"backend security\", \"audit API\", \"review service\".", "files": [ "CHECKLIST.md", "PATTERNS.md", "SKILL.md" ] }, { "name": "channel-listener", "description": "Read the sources you name — Teams/Slack channels, a code repo's commits and pull requests, a Confluence space, a tracker board or one person's tickets — and report only what is relevant to a project you name. You invoke it; it reads what is new since last time, checks each claim, and proposes what to do. Triggers on \"check my channels\", \"what did I miss\", \"what happened in \", \"anything new in \", \"what is on the board\", \"catch me up\", \"channel listener\".", "files": [ "SKILL.md", "reference/config.example.json" ] }, { "name": "code-reviewer", "description": "Comprehensive code review for quality, architecture, and performance. Use when reviewing PRs, auditing code quality, checking coding standards, evaluating design patterns, identifying performance bottlenecks, or analyzing technical debt. Triggers on \"review\", \"audit\", \"analyze code\", \"check quality\", \"code smell\".", "files": [ "CHECKLIST.md", "EXAMPLES.md", "SKILL.md" ] }, { "name": "coder-file-transfer", "description": "Upload or download large files to/from a Coder CDE workspace using the coder CLI. Use when transferring files, directories, build artifacts, datasets, or binaries to a Coder workspace, when `rsync -e \"coder ssh\"` fails or desyncs, or when a copy over `coder ssh` hangs/corrupts. Triggers on \"upload to coder\", \"copy files to workspace\", \"coder scp\", \"coder rsync\", \"transfer to CDE\", \"push files to my workspace\", \"coder config-ssh\".", "files": [ "SKILL.md" ] }, { "name": "cold-start-generator", "description": "Analyzes any microservice codebase and generates a complete cold-start package — CLAUDE.md, custom skills, requirements template, development process docs, and onboarding guide. Works for any architecture. Use when setting up AI-assisted development for a new project. Triggers on \"cold start\", \"set up AI development\", \"generate onboarding\", \"bootstrap project\", \"make this repo AI-ready\".", "files": [ "SKILL.md" ] }, { "name": "creating-skills", "description": "Create high-quality Claude Code skills with proper structure, effective descriptions, and best practices. Use when creating a new skill, writing SKILL.md files, setting up skill directories, or asking how to make skills.", "files": [ "CHECKLIST.md", "EXAMPLES.md", "SKILL.md", "TEMPLATES.md" ] }, { "name": "critical-thinking", "description": "Proactively challenge implementation plans, architecture decisions, and design assumptions. Use when reviewing plans, designs, or technical decisions. Verifies claims via web search, cross-references documentation, identifies risks and gaps, and surfaces hidden assumptions. Activates automatically when evaluating technical proposals. Also the escalation gate — the moment your instinct is to ask the operator, run this skill on the most capable model available and decide whether the question is really theirs.", "files": [ "BIASES.md", "FRAMEWORKS.md", "QUESTIONS.md", "SKILL.md", "VERIFICATION.md" ] }, { "name": "dark-factory-build", "description": "'End-to-end Dark Factory build orchestrator: intent to shipped software via the df-* stages, test-first, adversarially verified, autonomous in dev/non-prod, documented as stage docs plus tickets. Triggers on \"build this the dark factory way\", \"run a dark factory build\", \"take this spec to done end-to-end\".'", "files": [ "SKILL.md" ] }, { "name": "dependency-risk-auditor", "description": "Analyze third-party dependencies for security, maintenance, and lock-in risk. Use when auditing dependencies, reviewing new packages, or assessing supply chain security. Triggers on \"dependency audit\", \"package risk\", \"supply chain\", \"vulnerable dependencies\", \"license check\", \"outdated packages\", \"dependency review\", \"npm audit\", \"security scan\".", "files": [ "CHECKLIST.md", "LICENSE-REFERENCE.md", "SKILL.md" ] }, { "name": "df-adversary-gate", "description": "'Run the adversary gate: assess whether presented evidence proves a promise was kept, without redoing the work and never trusting a self-report. Use before trusting any \"done/passing\" claim, PR, or handoff. Triggers on \"adversary review\", \"verify\", \"gate\", \"assess evidence\", \"is this really done\".'", "files": [ "SKILL.md" ] }, { "name": "df-app-walkthrough", "description": "Record a narrated, captioned product walkthrough video of a web app end-to-end with no human in the loop — synthesized voice-over, a real browser driven with a visible cursor, burned-in captions, assembled to mp4. Works against a public website or an authenticated app (Clerk session-ticket, or any Playwright storageState). Use when asked to record a demo, produce a walkthrough or product tour, make a screen recording of an app, narrate a UI, generate a demo video, or turn a demo script into a video. Triggers on \"record a walkthrough\", \"make a demo video\", \"screen recording of the app\", \"product tour\", \"narrate the UI\", \"walkthrough video\".", "files": [ "SKILL.md", "package.json", "templates/narration.example.json", "tests/README.md" ] }, { "name": "df-context-store", "description": "Dark Factory Stage 0.5 — scaffold a repo's in-repo agent inner-loop substrate (read-first context store + single-responsibility agents + checkable hand-off contracts + commit gate) from the proven template, populate it from the real codebase, and verify it. Use when bootstrapping a repo for DF work, running a DF build, or adding the agent substrate to an existing repo. Triggers on \"context store\", \"agent substrate\", \"inner loop\", \"bootstrap agents\", \"df stage 0.5\".", "files": [ "SKILL.md", "substrate-template/CLAUDE-stanza.md", "substrate-template/README.md", "substrate-template/dotclaude/agents/README.md", "substrate-template/dotclaude/agents/feature-architect.md", "substrate-template/dotclaude/agents/implementer.md", "substrate-template/dotclaude/agents/investigator.md", "substrate-template/dotclaude/agents/knowledge-keeper.md", "substrate-template/dotclaude/agents/root-cause-analyzer.md", "substrate-template/dotclaude/agents/validator.md", "substrate-template/dotclaude/context/AGENT-CONTRACTS.md", "substrate-template/dotclaude/context/DATA-FLOW.md", "substrate-template/dotclaude/context/DECISIONS.md", "substrate-template/dotclaude/context/FINDINGS.md", "substrate-template/dotclaude/context/README.md", "substrate-template/dotclaude/context/SERVICE-MAP.md", "substrate-template/dotclaude/hooks/README.md", "substrate-template/dotclaude/settings.json", "substrate-template/dotclaude/skills/codebase-understanding/SKILL.md", "substrate-template/dotclaude/skills/commit-sync/SKILL.md", "substrate-template/dotclaude/skills/context-management/SKILL.md", "substrate-template/dotclaude/skills/contract-check/SKILL.md", "substrate-template/dotclaude/skills/dependency-mapping/SKILL.md", "substrate-template/dotclaude/skills/feature-planning/SKILL.md", "substrate-template/dotclaude/skills/root-cause-investigation/SKILL.md", "substrate-template/dotclaude/skills/test-strategy/SKILL.md" ] }, { "name": "df-data-transform-lens", "description": "Model any system as data nodes (schema, origin, authority) and transforms tagged pure|effect, governed by validation rules and an authority that resolves conflicts. The shared frame the other df-* skills build on. Triggers on \"data contract\", \"data flow\", \"validation rule\", \"transform\", \"pure or effect\", \"authority\", \"system of record\".", "files": [ "SKILL.md" ] }, { "name": "df-dispatch-subagents", "description": "'Dispatch sub-agents under Promise Theory: state the promise plus the exact unforgeable evidence required, withhold holdout cases, verify the evidence not the self-report. USE EVERY TIME you spawn a sub-agent. Triggers on \"dispatch sub-agent\", \"spawn agent\", \"parallel agents\", \"delegate\", \"fan out\".'", "files": [ "SKILL.md" ] }, { "name": "df-infrastructure", "description": "'Dark Factory Infrastructure stage: produce the Deployment and Infrastructure Spec — DTAP placement, where data lives, trust boundaries mapped to enforcement mechanisms, secrets, and a verified observability surface. Triggers on \"infrastructure\", \"deployment\", \"trust boundary\", \"where data lives\", \"deploy across environments\".'", "files": [ "SKILL.md" ] }, { "name": "df-observability", "description": "'Dark Factory Observability stage: make the consumable surface (dashboards and queryable traces keyed to scenarios, verified rendering live data) a named deliverable — a /metrics endpoint nobody can see is not observability. Triggers on \"observability\", \"dashboards\", \"Grafana\", \"correlationId trace\", \"telemetry surface\".'", "files": [ "SKILL.md" ] }, { "name": "df-product-owner", "description": "'Dark Factory Product Owner stage: define Vision, Requirements as data contracts plus validation rules, and Test Scenarios — the semantics every later stage derives from. Triggers on \"product owner\", \"requirements\", \"acceptance criteria\", \"test scenarios\", \"data contract\", \"what should we build\".'", "files": [ "SKILL.md" ] }, { "name": "df-qa", "description": "'Run the Dark Factory QA stage — execute the validation rules as tests, capture unforgeable evidence per scenario (by correlationId), run the holdout, and return a Works? verdict. QA is the OBSERVER: a self-report is not an assessment. Use when testing a deployed system, mapping PO scenarios to test cases, verifying with observability evidence, or judging a release. Triggers on \"QA\", \"test plan\", \"verdict\", \"evidence\", \"holdout\", \"E2E test\", \"does it work\", \"verify the release\".'", "files": [ "SKILL.md" ] }, { "name": "df-solution-architect", "description": "'Dark Factory Solution Architect stage: turn PO semantics into a Data Model, Data Flow (transform graph, pure|effect, idempotency, compensation) and Service Map, assigning each validation rule an enforcement locus. Triggers on \"architecture\", \"data model\", \"data flow\", \"service map\", \"schema\", \"Avro contract\", \"solution architect\".'", "files": [ "SKILL.md" ] }, { "name": "df-tdd-developer", "description": "'Dark Factory Developer stage: build a service test-first (RED-GREEN-REFACTOR) where the test list is the PO validation rules and scenarios, not invented. Go and Python examples. Triggers on \"TDD\", \"write tests\", \"test-first\", \"implement the service\", \"RED GREEN REFACTOR\".'", "files": [ "SKILL.md" ] }, { "name": "df-ui-verify", "description": "\"Drive and verify a Clerk-protected web UI end-to-end with a backend-minted session, no human login: mint the session, emit Playwright storageState, click through capturing per-scenario evidence and a verdict. Triggers on 'verify the UI', 'click through the app', 'test the front end', 'Clerk Playwright', 'authed UI test', 'UI evidence'.\"", "files": [ "SKILL.md", "test/fixtures/network_conditional_console.txt", "test/fixtures/network_fail.json", "test/fixtures/network_pass.json" ] }, { "name": "df-video-intake", "description": "Parse a video (mp4/mov/webm) into a transcript + timestamped frames so Claude can consume it, then extract context — specifically Dark Factory requirements — from it. Use when given a recording, demo, app walkthrough, screen recording, or \"video\" to summarize or turn into requirements/specs; when asked to \"watch\", \"process\", \"consume\", or \"transcribe\" a video; or to extract requirements/context from a demo for a dark factory build (PO vision, data contracts, validation rules, test scenarios).", "files": [ "SKILL.md" ] }, { "name": "dx-maintainability-reviewer", "description": "Evaluate how easy it is for new engineers to work in a codebase. Use when assessing code quality, onboarding friction, or technical debt. Triggers on \"code quality\", \"maintainability\", \"developer experience\", \"DX review\", \"onboarding\", \"cognitive load\", \"code smell\", \"refactoring\", \"tech debt\".", "files": [ "SKILL.md" ] }, { "name": "frontend-auditor", "description": "Audit frontend code for security, UX regressions, performance, and accessibility issues. Use when reviewing React, Next.js, Vue, Svelte, or any frontend code changes. Triggers on \"audit frontend\", \"review UI\", \"check accessibility\", \"a11y audit\", \"frontend security\", \"UX review\", \"performance audit\", \"review components\", \"audit React\".", "files": [ "CHECKLIST.md", "PATTERNS.md", "SKILL.md" ] }, { "name": "handoff", "description": "Publish a deliberate, structured Handoff document for the current objective into the active notepad and force a git push so it syncs across machines. Use when wrapping a session, handing to a teammate or fresh agent, hitting a milestone, or asked to \"create a handoff\", \"write a handoff\", \"checkpoint for next session\", \"hand this off\". Writes to /handoffs/-.md (NOT a temp dir), redacts secrets, references artifacts by path/URL, suggests next skills. In agent-notepad this is the on-demand Handoff tier — distinct from the continuous Notes tier (NOTES.md + journal). WARNING - 'hooks keep it fresh' holds ONLY on the compaction path, where pre-compact.sh writes a mechanical floor to PRECOMPACT.md, which the compact restore emits first. On /clear nothing does, because PreCompact never fires - so NOTES.md is whatever the agent last wrote, and it MUST be refreshed in the same commit as the handoff.", "files": [ "SKILL.md" ] }, { "name": "microservices-architect", "description": "Design and architect microservices following Chris Richardson's Microservices Patterns. Use when designing services, APIs, data flows, or evaluating architecture decisions. Guides full workflow from feature intake to production-ready design with observability, async patterns, security, testing, and deployment strategies.", "files": [ "AXIOMS.md", "CHECKLIST.md", "PATTERNS.md", "SKILL.md", "TEMPLATES.md" ] }, { "name": "production-readiness-reviewer", "description": "Verify whether a service, feature, or contract is safe to deploy to production. Use when preparing for deployment, reviewing release candidates, or validating production configs. Triggers on \"production ready\", \"deploy review\", \"release check\", \"pre-deploy\", \"go-live checklist\", \"launch readiness\", \"deployment review\", \"ready for prod\".", "files": [ "CHECKLIST.md", "RUNBOOK-TEMPLATE.md", "SKILL.md" ] }, { "name": "repo-docs", "description": "Generate comprehensive repository documentation following team standards. Use when creating README, CLAUDE.md, ARCHITECTURE.md, DESIGN_DECISIONS.md, or any project documentation. Includes Mermaid diagrams, status indicators, and AI context files.", "files": [ "CHECKLIST.md", "PATTERNS.md", "SKILL.md", "TEMPLATES.md" ] }, { "name": "requirements-discovery", "description": "Interactive requirements gathering that produces machine-executable specs for microservices. Guides conversation through structured rounds to produce a complete requirements doc where every section maps to a code artifact (SQL, Zod schemas, handlers, tests). Triggers on \"new feature\", \"new service\", \"requirements\", \"I want to build\", \"let's spec out\", \"define requirements\".", "files": [ "REQUIREMENTS-TEMPLATE.md", "SKILL.md" ] }, { "name": "sc-audit", "description": "Security auditor for smart contracts - identifies vulnerabilities, logic flaws, reentrancy, access control issues, MEV/economic attacks, and oracle manipulation. Use when auditing Solidity, Vyper, or Rust/Anchor contracts, reviewing PRs for security issues, checking for exploits, or analyzing DeFi protocols. Triggers on \"audit\", \"security review\", \"vulnerability\", \"exploit\", \"reentrancy\", \"access control\", \"MEV\", \"frontrunning\".", "files": [ "AUDIT-CHECKLIST.md", "POC-PATTERNS.md", "REPORT-TEMPLATE.md", "SKILL.md", "VULNERABILITIES.md" ] }, { "name": "sc-dev", "description": "Smart contract developer copilot for Solidity/EVM. Use when designing, implementing, refactoring, testing, or optimizing smart contracts; when adding features; when integrating with protocols; or when debugging failing tests.", "files": [ "CHECKLIST.md", "PATTERNS.md", "SKILL.md" ] }, { "name": "scope-init", "description": "'Create or refresh an agent-notepad — a per-objective working-memory git repo (one notepad per objective, grouped by name prefix) that survives context compaction and drives several code repos from one session. Runs a short interview (objective, code-repo paths, done-criteria), optionally `gh repo create`s the notepad under the prefix→org map (consent required), writes SCOPE.md + repos.manifest.json, validates each code repo, offers per-repo df-context-store bootstrap (consent), warm-starts NOTES.md from the repo stores, lays down the notepad template, and wires best-effort pull/push. Idempotent: re-running refreshes without clobbering NOTES.md or the journal. Use to start a new objective, spin up a notepad, \"init a scope\", or onboard an existing directory as a notepad. Triggers on \"scope-init\", \"new notepad\", \"start a scope\", \"init working memory\".'", "files": [ "SKILL.md" ] }, { "name": "scope-retire", "description": "'Archive a completed or abandoned agent-notepad while keeping its journal history intact. Marks the notepad retired (SCOPE.md status + a final journal milestone), stops it from auto-loading and syncing on future sessions, and preserves the append-only sessions/ history and handoffs for later recall — it never deletes the journal, the memory index entries, or the remote. Reversible: a later scope-init re-activates it. Use when an objective is done, a scope is being wound down, or a notepad should be shelved. Triggers on \"scope-retire\", \"retire this scope\", \"archive the notepad\", \"close out this objective\", \"wind down the scope\".'", "files": [ "SKILL.md" ] }, { "name": "security-threat-modeler", "description": "Identify attackers, assets, trust boundaries, and realistic attack paths. Use when analyzing security posture, reviewing new features for threats, or creating threat models. Triggers on \"threat model\", \"attack surface\", \"security analysis\", \"trust boundaries\", \"attacker goals\", \"threat assessment\", \"security review\", \"attack vectors\".", "files": [ "ATTACK-LIBRARY.md", "CHECKLIST.md", "SKILL.md" ] }, { "name": "service-mapper", "description": "Analyze a codebase to produce a complete service map — microservices, inter-service communication, database ownership, external integrations, and event flows. Generates AI-agent-friendly markdown. Use when onboarding to a new codebase, auditing architecture, updating CLAUDE.md, or before planning new features. Triggers on \"map services\", \"service map\", \"map the architecture\", \"what services exist\", \"how do services communicate\", \"map this repo\", \"generate service map\", \"architecture map\".", "files": [ "SKILL.md", "TEMPLATES.md" ] }, { "name": "test-quality-gatekeeper", "description": "Assess whether tests actually protect the system from regressions. Use when reviewing test coverage, evaluating test quality, or identifying missing tests. Triggers on \"test review\", \"test quality\", \"coverage gaps\", \"missing tests\", \"test assessment\", \"regression protection\", \"flaky tests\", \"test audit\".", "files": [ "CHECKLIST.md", "PATTERNS.md", "SKILL.md" ] }, { "name": "vercel-react-best-practices", "description": "React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.", "files": [ "AGENTS.md", "SKILL.md", "rules/advanced-event-handler-refs.md", "rules/advanced-use-latest.md", "rules/async-api-routes.md", "rules/async-defer-await.md", "rules/async-dependencies.md", "rules/async-parallel.md", "rules/async-suspense-boundaries.md", "rules/bundle-barrel-imports.md", "rules/bundle-conditional.md", "rules/bundle-defer-third-party.md", "rules/bundle-dynamic-imports.md", "rules/bundle-preload.md", "rules/client-event-listeners.md", "rules/client-localstorage-schema.md", "rules/client-passive-event-listeners.md", "rules/client-swr-dedup.md", "rules/js-batch-dom-css.md", "rules/js-cache-function-results.md", "rules/js-cache-property-access.md", "rules/js-cache-storage.md", "rules/js-combine-iterations.md", "rules/js-early-exit.md", "rules/js-hoist-regexp.md", "rules/js-index-maps.md", "rules/js-length-check-first.md", "rules/js-min-max-loop.md", "rules/js-set-map-lookups.md", "rules/js-tosorted-immutable.md", "rules/rendering-activity.md", "rules/rendering-animate-svg-wrapper.md", "rules/rendering-conditional-render.md", "rules/rendering-content-visibility.md", "rules/rendering-hoist-jsx.md", "rules/rendering-hydration-no-flicker.md", "rules/rendering-svg-precision.md", "rules/rerender-defer-reads.md", "rules/rerender-dependencies.md", "rules/rerender-derived-state.md", "rules/rerender-functional-setstate.md", "rules/rerender-lazy-state-init.md", "rules/rerender-memo.md", "rules/rerender-transitions.md", "rules/server-after-nonblocking.md", "rules/server-cache-lru.md", "rules/server-cache-react.md", "rules/server-parallel-fetching.md", "rules/server-serialization.md" ] }, { "name": "vinculum-loop", "description": "'Run the autonomous, evidence-gated, Promise-Theory-verified control loop (the Vinculum governed loop + Dark Factory process) on any dev project. Use when the user wants to hand over a mission objective with full autonomy under a 2-trigger notify contract (done | blocked-on-all-fronts), evidence-gated decisions (Promise Theory, not self-reports), and an A/B/C decision policy. This is the single entry point that explains how the loop works and points to the dark-factory-build orchestrator. Trigger phrases: \"run the loop\", \"vinculum loop\", \"give me a mission and full autonomy\", \"autonomous build\".'", "files": [ "SKILL.md" ] }, { "name": "vinculum-map", "description": "Chart and work a Mission Map — a tracker-hosted index of decisions and tickets that carries a multi-session build across context resets. Use to start a long mission, claim the next ticket, record a decision, or resume after a handoff. Triggers on \"chart the map\", \"mission map\", \"next ticket\", \"resume the mission\", \"what's the frontier\".", "files": [ "SKILL.md" ] }, { "name": "web-design-guidelines", "description": "Review UI code for Web Interface Guidelines compliance. Use when asked to \"review my UI\", \"check accessibility\", \"audit design\", \"review UX\", or \"check my site against best practices\".", "files": [ "SKILL.md" ] }, { "name": "work-autonomously", "description": "Default operating stance — act autonomously inside reversible, non-production surfaces, and HARD-STOP for explicit permission before any irreversible real-world action. Resolve ambiguity through the toolchain (durable memory → working notepad → internet → codebase → team docs) before spending the operator's attention. Session-wide, not per-task.", "files": [ "SKILL.md" ] } ] }