Skill Map

Use this page to find the right ACT entrypoint for any task.

Tip

Run /act-help in the CLI to explore available commands, agents, and skills interactively.

Codex invocation

The tables use /act-* notation for the canonical ACT names. In Codex, discover ACT skills with /skills or mention the same skill as $act-* where supported, for example $act-workflow-plan.

Workflow skills

Skill	Purpose
/act-workflow-spec [task]	Define what to build
/act-workflow-refine-spec [spec-file]	Validate a spec for gaps
/act-workflow-plan [spec-file]	Create an implementation plan
/act-workflow-plan [spec-file] --use-subagents	Create a plan with deep research
/act-workflow-work <plan-file>	Execute a plan
/act-workflow-compound [context]	Capture session insights

Note

/act-workflow-work takes optional arguments such as --single-phase, --do-not-commit, and --create-pr. See Work for all the details.

Git skills

Skill	Purpose
/act-git-commit	Commit staged changes
/act-git-commit-all	Commit all changes
/act-git-push-make-pr	Push and create a PR
/act-git-switch-main-pull	Switch to main and pull
/act-git-worktree [action]	Manage worktrees

Flutter and setup skills

Skill	Purpose
/act-flutter-create <name>	Create a Flutter project
/act-dart-create <name>	Create a Dart CLI project
/act-flutter-pub-upgrade-major	Upgrade all dependencies
/act-flutter-screenshot [path]	Take a screenshot for verification
/act-flutter-driver-mcp [setup|verify|troubleshoot]	Set up Flutter Driver entrypoints for Dart MCP runtime interaction
/act-figma-to-flutter [setup|url|selected node]	Inspect Figma MCP designs before Flutter implementation
/act-flutter-development	Get Flutter development guidance
/act-flutter-tdd	Set up TDD discipline
/act-flutter-robot-testing	Set up robot journey tests
/act-flutter-drift-setup	Set up Drift/SQLite database
/act-flutter-sentry-init <project> <org>	Set up Sentry error reporting
/act-download-flutter-rules	Download official Flutter rules
/act-flutter-development [official|lite|full|topic]	Load Flutter knowledge directly

Commands that remain command-based

These public ACT utilities remain command-based on slash-command clients. In Codex, act-help and act-update are installed as generated skills.

Command	Purpose
/act-update	Update ACT
/act-help [name]	Get help

Supported Agents

These research agents are used by /act-workflow-plan when you pass the --use-subagents flag.

Agent	Purpose
act-codebase-researcher	Research project structure, patterns, and conventions
act-flutter-docs-researcher	Gather Flutter/Dart SDK or package documentation
act-flutter-patterns-researcher	Research Flutter/Dart patterns and principles from ACT knowledge

Typical questions

I want to…	Use
Understand the full workflow	Workflow Overview
Compare supported client behavior	Platform Support
Understand the migration from older docs	Commands to Skills Migration

Typical workflow

1. Spec — /act-workflow-spec "description"
2. Refine (optional) — /act-workflow-refine-spec ai_specs/feature-spec.md
3. Plan — /act-workflow-plan ai_specs/feature-spec.md
4. Work — /act-workflow-work ai_specs/feature-plan.md
5. Compound (optional) — /act-workflow-compound

For quick fixes, skip spec and go straight to /act-workflow-plan "fix the save button crash", then run work on the generated plan file.