Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

spiderocious/skills

A collection of opinionated, battle-tested agent skills for shipping production software — full-stack architecture, fintech-grade APIs, QA methodologies, and a few things you won't find anywhere else.

These aren't "best practices" reference dumps. Each skill is a set of hard rules with the bug each one prevents, drawn from real production incidents. Install the ones that match your stack; your coding agent loads them automatically when the moment matches.

Install

npx skills add spiderocious/skills@<skill-name>

For example:

npx skills add spiderocious/skills@production-hard-lessons
npx skills add spiderocious/skills@rest-api-contract
npx skills add spiderocious/skills@meemaw

Add -g to install globally (user-level) and -y to skip confirmation.

The skills

Frontend & React

Skill What it gives you
fsd-react A complete, enforced Feature-Sliced Design layout for React + TypeScript — screen/parts/widgets/api/guards/providers, the 200-line screen rule, progressive disclosure.
react-state-discipline The strict state hierarchy: server (React Query) → feature (Context) → screen (useState) → URL. No Redux, no Zustand. staleTime-by-data-type, query keys as constants.
meemaw Declarative conditional rendering & iteration with the meemaw library — <Show>, <Switch>, <Repeat>, <Loadable>. Kills the &&-renders-0 bug and .map() key traps.

Backend & APIs

Skill What it gives you
rest-api-contract Fintech-grade REST contracts: stable error-code envelopes, cursor pagination, idempotency, branded money types, a precise HTTP status matrix (202/410/422).
service-result-pattern Never throw from the service layer — return ServiceResult<T>. The 3-layer error funnel, message-key i18n, request context via AsyncLocalStorage.
money-and-ledgers Correct money handling in Postgres: append-only ledgers, BIGINT minor units (never float), branded TS types, balance caches, deferred constraints.
mobile-first-api Designing APIs when mobile is the primary client: versioning doctrine, idempotency as a requirement, push payloads as contract, WebSocket reconnection.

QA & testing

Skill What it gives you
browser-qa-agent A methodology for an agent to QA a web frontend through a real browser — journey mapping, modal/controlled-input gotchas, code-flow audits, P0–P3 reports.
api-qa-agent Test any REST API from zero knowledge to bug report. "Docs lie; code is truth." Recon → divergence analysis → seed → curl/psql/redis playbooks.
contract-drift-hunter Catch the silent bugs at the backend/frontend seam: field renames, pagination-shape drift, money serialization. Shared-Zod-schema contract tests.
testing-pyramid A full testing strategy biased toward integration: Testcontainers (start-once/truncate), contract tests as a CI gate, E2E flows, k6 load, a production canary.

Architecture & tooling

Skill What it gives you
monorepo-rules pnpm monorepo discipline: workspace:*, the package dependency DAG, supply-chain release-age guard, no-barrels-in-features, module-resolution differences.
ts-ci-standards TypeScript strictness + lint + format + CI gates: noUncheckedIndexedAccess/exactOptionalPropertyTypes (and their traps), husky hooks, the CI matrix, a PR checklist.
flutter-fsd Feature-Sliced Design for Flutter — a custom QueryNotifier (React Query for Dart), sealed-class state, go_router guards, secure storage, Freezed.

Craft

Skill What it gives you
demo-director Produce premium product launch films by scripting code, not screen-recording. Films are rendered (Remotion), never recorded. Recon → recreate → art-direct.

Philosophy

  • Opinionated over comprehensive. A rule that prevents a real bug beats a survey of options.
  • Generalized. Every rule applies to your own codebase, not the author's. Private libraries are taught as patterns you build, with one exception: meemaw, which is published and npm install-able.
  • Cross-referenced, mostly self-contained. Install one skill and get what you need; sibling skills are linked where they go deeper.

License

MIT © spiderocious

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors