superpowers
claudecodexCore skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
15 skills · hooks
Turns raw ideas into shipped gold. 75+ Flutter skills covering product planning, premium Material 3 design, clean architecture, Riverpod, backend, security, testing, CI/CD, Play Store deployment, autonomous maintenance, crash triage, semantic indexing, token economy, and more. Master Orchestrator drives the full pipeline.
Plugin alchemist from marketplace android-skills in RICH-KEED/Alchemist. Commands read from the repo's manifest — 1 month ago.
Master OrchestratorDrive an entire Flutter app from idea to production. Use when the user wants to build a complete Flutter/Android app, start a new app project, or asks "build me an app". Sequences the 24-stage pipeline (product → design → architecture → build → test → ship), tracks progress in .flutter-pipeline/STAT
Product PlanningTurn a raw app idea into a crisp Product Requirements Document — problem statement, personas, user stories with acceptance criteria, a true MVP scoped by MoSCoW, and a North Star + supporting metrics. Use at the very start of a Flutter/Android build, right after the idea exists and before any UX or
UI UX PlanningTurn a PRD into the app's UX blueprint — information architecture, navigation model, screen inventory, user flows, and low-fi wireframes. Use after Product_Planning (stage 02) when you have docs/PRD.md and need to decide what screens exist, how users move between them, and which Material 3 navigatio
Premium Design SystemBuild a premium Material 3 design system from a PRD/UX — define design tokens (color, type, spacing, radii, elevation, motion), wire them into ThemeData + a custom AppTokens ThemeExtension for light & dark, and mock the kit in a .pen file. Use when starting visual design, setting up theming, definin
App PreviewProduce a visual preview/prototype of the app before building it, so look & feel can be approved early. Use after the design system exists (stage 04) to create .pen mockups, a runnable Flutter widget gallery, and device screenshots for stakeholder sign-off. Trigger on "show me what it'll look like",
Flutter ArchitectureScaffold a new Flutter app and lay down its architecture. Use when starting the codebase (pipeline stage 06), running `flutter create`, setting up `lib/` layout, wiring Riverpod DI + the repository pattern, or adding a new feature module. Output is a scaffolded `lib/` that passes `flutter analyze` a
NavigationWire up app navigation with go_router driven by a Riverpod routerProvider — typed routes, a StatefulShellRoute bottom-nav with preserved tab state, auth redirects/guards, a 404 error route, and deep links / Android App Links. Use after the app is scaffolded (stage 06) and you have a screen inventory
Riverpod State ManagementStandardize app state on Riverpod 2.x with code generation. Use when wiring screen state, building controllers/notifiers, doing DI, or when the user mentions "state management", "Riverpod", "provider", "AsyncNotifier", or "where does this state live". Produces @riverpod controller + state scaffolds
AnimationAdd tasteful, performant motion to a Flutter app — implicit vs explicit animations, page/shared-axis/container transitions, Hero continuity, staggered lists, and micro-interactions. Use when a screen needs transitions, a widget should animate state changes, lists should animate in, or the app needs
Asset ManagementBuild a clean, type-safe asset pipeline for a Flutter/Android app — images (with resolution variants), fonts, SVGs, an adaptive launcher icon, a native splash, and per-flavor assets. Use when adding images/fonts/icons, wiring flutter_gen, setting up the app icon or splash screen, handling remote ima
Backend IntegrationConnect a Flutter app to a backend. Use when wiring the data layer (pipeline stage 11) — configuring the dio client, adding interceptors (auth, logging), writing remote data sources + repositories that return Result, mapping DTO↔domain, or deciding REST vs GraphQL vs Firebase/Supabase. Output is end
API TestingTest the networking/data layer without hitting real servers — mock the dio client, parse DTOs from JSON fixtures, assert repository DTO→entity and error→Failure mapping, and pin contracts so a backend change breaks a test. Use after Backend_Integration (11) when the user says "test the API", "mock t
SecurityHarden a Flutter/Android app — secure token & secret storage, TLS certificate pinning, build obfuscation/minification, secrets management, biometric auth, and an OWASP MASVS-L1 checklist. Use when wiring secure storage for tokens, pinning certificates, removing secrets from the repo, gating sensitiv
Network ResilienceMake a Flutter app robust to bad networks — bounded retries with exponential backoff + jitter, sane timeouts, connectivity detection, offline caching, write queues, and a circuit breaker. Use when the app must survive slow/flaky/offline networks or 5xx servers, when adding retry/timeout logic to the
Error HandlingMake errors first-class. Use when wiring error handling, defining the Failure/Result types, mapping exceptions at the data boundary, adding a global error boundary, or designing user-facing error states. Owns the canonical core/error/result.dart + failure.dart that every other skill imports. Pipelin
Loading StatesRender every async surface's four states — loading, data, empty, error — consistently and premium. Use when a screen fetches data, shows a spinner, "feels janky / blank / flickers", needs skeletons/shimmer, an empty state, a retry, pull-to-refresh, pagination, or optimistic updates. Produces a reusa
Responsive UIMake every screen adapt across phone, tablet, and foldable in both orientations — Material 3 window size classes + a breakpoint set, LayoutBuilder/MediaQuery, an adaptive navigation switch (NavigationBar ↔ NavigationRail ↔ extended rail/Drawer), and a list/detail (master-detail) layout. Use when the
DocumentationWrite the documentation that actually matters for a Flutter app — a strong README, Architecture Decision Records (ADRs), an architecture overview, a CONTRIBUTING guide, and dartdoc on public APIs. Use when a project needs onboarding docs, a record of why decisions were made, or generated API docs. S
GitHub WorkflowSet up repository hygiene and collaboration for a Flutter app — branching strategy, Conventional Commits, PR/issue templates, CODEOWNERS, a Flutter .gitignore, and review norms. Use when initializing a repo, fixing messy git history/process, or wiring the `.github/` folder before CI (stage 21) runs
TestingBuild the app's test strategy and infrastructure — the test pyramid for this stack (lots of unit on domain/application, focused widget tests, a few golden + integration), Riverpod ProviderScope overrides in widget tests, golden tests in light+dark at fixed sizes, integration smoke flows, test-data b
CICDAutomate build, test, sign, and distribute for a Flutter/Android app. Use when wiring GitHub Actions (analyze, test with coverage, build a signed AAB), adding Fastlane lanes, choosing Codemagic as an alternative, or injecting a signing keystore from CI secrets. Stage 21 of the pipeline.
DeploymentShip a Flutter app to the Google Play Store — versioning, release signing (upload key + Play App Signing), building a signed app bundle, Play Console tracks (internal → closed → open → production), staged rollout, and store metadata. Use when cutting a first release, setting up release signing, publ
MonitoringWire production observability into a Flutter app — crash reporting, analytics, performance, and structured logging. Use when adding Sentry/Crashlytics, instrumenting PRD success metrics, capturing frame/trace metrics, or routing logs to breadcrumbs. Pipeline stage 23; completes the crash hooks skill
Production ReadinessRun the final go/no-go launch audit for a Flutter/Android app — walk every pipeline gate (02–23) and audit the cross-cutting concerns (performance, stability, security, accessibility, store compliance, privacy, observability, release hygiene, docs), then produce a GO / NO-GO / CONDITIONAL report. Us
Context Compression EngineCompress large pipeline artifacts (PRD, UX, STATE, source files) into dense, lossless-enough "context cards" that downstream skills load instead of full docs — cutting per-stage tokens 40-70% as the project grows. Use when the orchestrator or a stage skill is about to re-read a big artifact, when co
Codebase Semantic IndexBuild and maintain a persistent, incremental index of a Flutter app's symbols so skills query the index instead of re-reading the tree. Use when a skill needs to find where something lives ("where is auth state?", "list all routes", "what depends on X?"), when onboarding to an unfamiliar app, or whe
Diff-Scoped Context LoaderFor any edit task, load ONLY the changed files plus their direct dependents instead of the whole feature tree — bounding context to O(change). Use before editing existing Flutter code, when reviewing a diff, or when asked "what does this change affect / what should I re-test". Trigger phrases — "sco
Skill Router & Minimal-Load PlannerGiven a user request, select the SMALLEST set of skills/templates to load (avoid pulling all ~70 skill descriptions) — expand to their dependency closure, order them, and feed the orchestrator or a direct invocation. Uses a machine catalog of trigger-keyword-to-skill maps, then scores the request ag
Token Budget Governor & Cost PredictorPredict the token and dollar cost of a task BEFORE running it, enforce a ceiling, and degrade gracefully when a budget would be exceeded. Use before any big multi-skill operation, when the user sets a budget or asks "how much will this cost", or when the orchestrator is about to run a phase. Reports
Autonomous Maintenance AgentScheduled agent that bumps deps/SDK, fixes new lints, regenerates code, runs tests, and opens a PR — proactive health sweeps on a cron-based cadence. Use to keep a Flutter project evergreen between features. Pairs with #33 Self-Healing CI (which reacts to red runs) and delegates fixes to #37 (build)
Self-Healing CI AgentOn a CI failure, ingest the run logs, classify the failure family, apply a targeted fix, commit, and re-run — escalating to a human if unresolved after N attempts. Use when a GitHub Actions job goes red and you want the agent to triage and self-repair instead of hand-debugging. Delegates build error
Crash Free WatchdogWatch Sentry/Firebase Crashlytics for new crash signatures or crash-free % drops — triage and open a GitHub issue with suspect code from git blame for every actionable signal. Use when "crash-free rate dropped", "a new crash signature appeared in prod", "Sentry shows a spike", "Crashlytics is lighti
Skill Telemetry & Self-TuningRecords every skill run's outcome, token cost, and duration to a local telemetry log, then rolls up per-skill means that feed the Cost Predictor (#30) and Skill Router (#28) so the system measurably improves. Use after any skill invocation to append a record, and whenever you want a per-skill rollup
Codebase OnboardingPoint at an existing Flutter repo and get a complete architecture map, convention analysis, risk hotspots, and "how to add X" guide — a 15-minute ramp doc for any team member. Use when joining a new project, inheriting a codebase, reviewing an unfamiliar repo, or onboarding a teammate. Produces the
Build DoctorDiagnose Flutter/Android build failures from raw logs and propose the exact fix. Use when a build breaks with Gradle/AGP/Kotlin/JDK version mismatches, "namespace not specified", "Could not resolve" deps, NDK/multidex/minSdk errors, R8/ProGuard failures, CocoaPods errors, or pub "version solving fai
Runtime Exception TriageTurn a production crash signature into a located, hypothesized, fixable bug. Use when handed a Dart/Flutter stack trace or a Crashlytics/Sentry signature — symbolize it, map frames to file —line via the #26 index, hypothesize the root cause, and propose a fix plus a regression test. Trigger phrases
Performance ProfilerFrom a DevTools timeline export, --profile trace, or frame rendering stats, identify excessive rebuilds and slow frames, then recommend const, select, RepaintBoundary, and isolate offload fixes with before/after estimates. Use when the app drops frames, scrolling stutters, animations judder, or the
State Leak AuditorScan a Flutter/Dart project for undisposed controllers, uncancelled subscriptions, missing autoDispose on Riverpod providers, and other resource leaks that drain memory or keep dead listeners alive. Use when you want to audit a codebase for leaks — pre-commit, in CI, or as a one-shot health sweep.
Analyzer Auto-Fix LoopDrive `flutter analyze` to ZERO under very_good_analysis with minimal toil — format, dart fix, analyze, categorize, auto-resolve mechanical issues, loop until clean. Use when the analyzer reports warnings/infos/errors, before any stage gate, or when a CI lint check fails. Trigger on "fix analyzer",
Architecture DebateSpawn N advocate agents + a judge for hard architecture decisions — state lib, offline strategy, modularization, backend choice — and produce a scored recommendation plus an ADR. Use when the answer is multi-sided and the cost of a wrong choice is high.
Design Critic AgentCapture a screenshot of a built (or mocked) screen and adversarially critique it against the design system + a PREMIUM rubric, then return prioritized, code-tied fixes. Use when a screen "looks generic / off / cheap", before a design sign-off, or when asked to "review the UI", "critique this screen"
Visual RegressionPixel-diff agent — capture golden screenshots of every key screen across theme (light/dark) × size and diff them on every change to catch UNINTENDED visual deltas unit tests miss. Use for "visual regression", "golden screenshots", "pixel diff", "my UI changed and I didn't mean it to", or wiring gold
Accessibility AuditorAudit a Flutter/Android screen or app for accessibility — Semantics labels, WCAG AA color contrast, 48dp touch targets, dynamic type up to 2.0x, focus order, TalkBack traversal, and reduce-motion — then return prioritized, code-tied fixes. Use when asked to "audit a11y", "check accessibility", "make
Figma BridgeImport Figma frames, variables, text styles, and auto-layout metadata — map them onto the project's design tokens (ColorScheme + AppTokens from skill 04), then emit a token mapping document and optional Flutter widget stubs. Use when connecting a Figma file to a Flutter codebase, translating Figma v
Screenshot To WidgetReconstruct an editable Flutter widget tree from a screenshot of any app — map visual elements to project design tokens and produce compilable, themed Dart widgets. Use when you have a screenshot of a UI you want to reproduce in Flutter, or when asked to "recreate this screen", "copy this design", "
Motion CriticAudit all animations against AppTokens.motion — flag ad-hoc duration/curve literals, jarring transitions, missing motion, and 60fps violations. Use after animation work, before a design sign-off, or when motion "feels off".
OpenAPI Dart GeneratorGenerate the house-style data layer from an OpenAPI/Swagger spec — dio remote data sources, freezed + json_serializable DTOs, and repositories returning Result. Use when you have an OpenAPI/Swagger contract (openapi.json/yaml) and want to eliminate hand-written API plumbing instead of typing data so
Localization & i18n EngineExtract hardcoded UI strings into ARB and wire flutter_localizations + intl with ICU plurals, RTL, and text-expansion readiness. Use when the user says "localize", "i18n", "internationalization", "translations", "ARB", "multi-language", "RTL", "right-to-left", or "support another language", or when
DB Migration GeneratorFrom domain entities — generate Drift schema definitions, DAOs with typed queries, forward migrations with round-trip tests, and diff old vs. new schema. Use when adding or changing persistent models, creating a new schema version, reviewing migration safety, or generating a full Drift data layer fr
Push NotificationsEnd-to-end Firebase Cloud Messaging in Flutter — Android 13+ runtime permission, typed freezed payload models, foreground/background/terminated handlers, deep-link routing from notification tap. Use when adding push notifications, wiring FCM, handling notification taps for navigation, or setting up
Background SyncSchedule durable periodic background work with WorkManager + Dart isolates — outbox flush, data sync, and dead-letter recovery — so the app stays consistent even when the user is not looking. Use when writes must drain offline, when data must refresh on a cadence, or when retries from #14 have been
Feature FlagsType-safe feature flag system wrapping Firebase Remote Config with local overrides, feature gating, kill-switch, and experiment-ready variants — for controlled rollout, A/B testing, and emergency off-switches. Use when you need runtime feature toggles, staged rollouts, developer overrides, or server
Form EngineGenerate validated forms from a JSON schema — wired to Riverpod AsyncNotifier, Material 3, and AppTokens with per-field error UX and submit returning Result<T>
Dependency Health MonitorScore every pub.dev dependency on maintenance, popularity, null-safety/Dart-3 support, known vulnerabilities, abandonment risk, size impact, and breaking-change risk, then emit a health report + prioritized upgrade plan. Use when the user asks "are my dependencies healthy/safe/up to date", before a
Package Recommendation EngineGiven a capability need (charts, secure storage, local db, image picker, notifications…) recommend the single best pub.dev package by weighing #56 health, license, size, null-safety/Dart-3, maintenance, platform support, and fit with the house stack (Riverpod/dio/freezed) — with a runner-up fallback
Compliance_SBOMResolve transitive licenses — flag GPL/AGPL risk, generate NOTICE + CycloneDX SBOM, gate release
Privacy Manifest & Play Data-Safety GeneratorScan a Flutter/Android app's SDKs, permissions, and data flows to auto-draft the Google Play Data Safety form, the iOS privacy manifest (PrivacyInfo.xcprivacy), and a privacy-policy starting draft — so store submissions aren't rejected for wrong or missing data declarations. Use when prepping a Play
60_Threat_ModelingSTRIDE over app data flows — ranked threats + mitigations mapping to skill 13
61_Secrets_ScannerPre-commit/CI scan for API keys, tokens, keystores, google-services.json, and base64 blobs — Flutter/Android-tuned. Catches Google API keys, Firebase configs, AWS keys, GitHub tokens, private keys, OAuth client secrets, keystore files, and suspicious base64 blobs. Trigger: before every commit or CI
white_label_engineFrom a brand config matrix (colors — name — icon — endpoints) — generate N flavored signed Android builds using Flutter flavors — Material 3 per-brand theming — and CI matrix orchestration
Decision Ledger & ProvenanceCapture every significant decision (stack, library, architecture, trade-off) as a numbered, linked ADR with a requirement → decision → code trace — so institutional memory persists and settled choices are never re-litigated. Use when a pipeline stage makes a call worth remembering, or before re-deci
App Store OptimizationOptimize the Google Play Store listing for conversion — title, subtitle, keywords, full description, short description, screenshots order, and localized store listings. Use before Play Store submission, when conversion is low, or when localizing to new markets.
Changelog GeneratorGenerate human-readable changelogs and Play Store "What's New" text from Conventional Commits between two git tags — group by type (feat, fix, perf, docs), rewrite in user-facing tone, and output both a markdown changelog and a Play-ready summary.
analytics-taxonomyDesign a typed, privacy-safe analytics event taxonomy from PRD success metrics — auto-instrument screen views, user actions, business outcomes, and errors tied to Firebase Analytics and stage 23 monitoring
AB ExperimentWire A/B experiments on top of Remote Config — variant assignment, exposure logging, guardrail metrics, and a clean experiment harness. Use when you need to test a feature variant, measure conversion impact, or run a controlled rollout.
68_Performance_BudgetEnforce CI gates on AAB/APK size — cold-start ms — frame budgets. Fail PRs that regress >5% vs committed baseline. Trigger — performance regression — size budget — cold start — jank — frame budget — CI gate failure — size increase on PR.
Device MatrixRun integration and golden tests across a real device matrix via Firebase Test Lab — cover low-end devices, foldables, tablets, and multiple API levels. Use before a release to verify hardware diversity, or when a bug is suspected on a specific device class.
Test Generation AgentGiven a target (screen widget, Riverpod controller/notifier, repository, or pure logic), GENERATE meaningful tests — happy + edge + error — by inferring the behaviors worth asserting from types and states. Use when the user says "generate tests for this", "write tests for <file>", "cover this contro
Mutation Testing HarnessMutate Flutter/Dart source — re-run tests — surviving mutants reveal weak or assertion-free tests. Coverage % lies; mutation score measures real strength. Use after stage 20 Testing to find blind spots and harden the test suite before release.
Contract Golden DriftDetect when backend responses drift from pinned contracts (OpenAPI) or golden snapshots — classify whether goldens need a legitimate update or signal a real regression. Use when a backend changes, API tests suddenly fail, or you need to audit live responses against the pinned spec.
Regression_MemoryRecords every fixed bug's signature/root-cause/fix/guarding-test — warns when a change risks reintroducing one. Feeds skill 38 (Runtime_Exception_Triage).
Chaos ResilienceInject failures deliberately — network loss, slow API (high latency), denied permissions, low memory, clock skew, killed isolate/process — and assert the app degrades gracefully per the contracts from skills 14/15/16. Use to harden resilience before production, audit the resilience stack, or gate st
User Onboarding & Coach MarksAdd first-run onboarding and in-context feature coaching to a Flutter app — an intro/welcome flow plus ShowcaseView/FeatureDiscovery coach marks that spotlight key actions, shown only on first launch, with persisted completion state and replay from Settings. Use when the user says "add onboarding",
Cross-Project Pattern LibraryAccumulate proven reusable patterns learned across Flutter projects into a global session-persistent store (~/.flutter-pipeline/patterns.json) — and consult that store before generating solutions from scratch. A pattern is a canonical problem+context+solution triple that has been proven across N pro
Store & Docs PublisherAuto-generate the full publishing package for a Flutter/Android app — README + architecture docs + ADRs + dartdoc, Play Store copy (title, short/long description, whats-new), Play Store listing images (feature graphic, phone screenshots, tablet screenshots — with device frames at exact required dime
InitializeStart an interactive, continuous app build loop. Triggered via /initialize — asks for app details (name, idea, platform, constraints), then runs the full Alchemist pipeline (stages 02→24) with self-testing and refinement passes until every gate is green. When complete, delivers a build-ready artifac
App Icon GeneratorGenerate the complete app icon suite for Android (and iOS) — all 9 density buckets from mdpi to xxxhdpi, adaptive icon layers (foreground, background, monochrome for Android 13 themed icons), notification icon, and the Play Store 512×512 icon. Uses flutter_launcher_icons to auto-apply. If the user h
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
15 skills · hooks
Up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your coding agent's context.
1 MCP server
Build powerful, stateful CLI interfaces for any GUI application using the cli-anything harness methodology.
5 commands
Automates browser interactions for web testing, form filling, screenshots, and data extraction
12 skills
Use Alibaba Open Code Review from local Codex.
2 skills
Claude Code skill for creating and presenting Slidev slidedecks
1 skill
This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.