stuc-mode

Applies opinionated Android/Kotlin agent workflows with playbooks, principles, and verification loops.

1|Updated Aug 26, 2026
One-click install
npx skills add https://github.com/edivad1999/stuc-stack --skill stuc-mode-edivad1999
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: stuc-mode
Source: https://github.com/edivad1999/stuc-stack/tree/main/skills/stuc-mode
Command: npx skills add https://github.com/edivad1999/stuc-stack --skill stuc-mode-edivad1999

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander, and includes scripts (resource) and references (resource) components.

What problem does it solve? AI coding agents often produce verbose prose, unverified claims, and inconsistent architecture decisions on Android/Kotlin projects. This Skill enforces a disciplined working style: concise replies, named engineering principles, structured playbooks for common tasks, and mandatory runtime verification before declaring work done. ## Core Features & Use Cases - Named principles and playbooks: Routes tasks like bug fixes, features, refactors, perf work, and PR babysitting through step-by-step playbooks grounded in cited principles (e.g., Prove It Works, Model the Domain). - Verification loop: Requires Gradle assemble plus the android CLI to prove Android UI and device behavior on the real artifact, never accepting "it compiles" as done. - Subagent orchestration: Prescribes deliberate delegation with per-role models, parallel design exploration, and adversarial review for contested designs. - Use Case: Ask the agent to fix an Android crash in /stuc-mode; it reproduces the bug on a device via the android CLI, root-causes it, delegates the fix, verifies the repro now passes, and opens a PR with evidence. ## Quick Start Ask the agent to work in stuc-mode on your Android or Kotlin task, for example by saying "use /stuc-mode to fix this Compose recomposition bug and verify it on device".

Frequently Asked Questions about stuc-mode

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use stuc-mode for Android development tasks?▼

Invoke /stuc-mode or ask the agent to work in this stack's style. It matches your task to a playbook (bug fix, feature, refactor, perf), copies the playbook steps into a todolist, and verifies results on a real device through the android CLI after Gradle assemble.

What upstream skills does stuc-mode require?▼

It requires the chrisbanes/skills clusters (compose-state-and-effects, kotlin-concurrency-and-flow, kotlin-api-design, and others) plus the official android-cli skill from android/skills. The /setup-stuc command probes for these names and fails closed if they are missing.

Does stuc-mode work with Cursor, Claude Code, and Codex?▼

Yes, the repository ships manifests for Cursor (.cursor-plugin/), Claude Code (.claude-plugin/), and Codex (.codex-plugin/). Each platform has its own install flow, and upstream plugins must be installed before stuc-stack itself.

How does stuc-mode verify Android UI changes?▼

It runs the android-verify flow: Gradle assemble first, then drives the device with the android binary (describe, run, layout, screen). It refuses to claim verification that was not run and treats inconclusive or wrong-surface results as failures.

When should I not use stuc-mode?▼

Skip it for casual conversational turns or when the user opts out of the stack's style. It is designed for substantive Android/Kotlin engineering work where rigor, playbooks, and verification matter, not quick chat replies.