Commands to Skills Migration
ACT versions prior to 0.4.0 defined most toolkit functionality as commands. Starting in 0.4.0, ACT fully moved to skills as the primary interface.
Skills are an evolution of the earlier command model. They keep the same goal of packaging repeatable workflows, but they are more portable across different CLIs, which makes them a better long-term fit for ACT.
Overview
Section titled “Overview”Before 0.4.0, the ACT surface area mixed several styles:
- namespaced commands such as
/act:workflow:plan - namespaced git and meta commands such as
/act:git:push-make-pr - ACT-owned skills without a consistent prefix such as
/flutter-create
From 0.4.0 onward, the docs treat skills as the canonical interface for most ACT functionality:
- workflow, git, and meta entrypoints are documented as direct
act-*skills - ACT-owned skills use
act-*names for consistency - only a smaller set of toolkit utilities remain command-based
Examples:
/act:workflow:plan->/act-workflow-plan/act:git:push-make-pr->/act-git-push-make-pr/flutter-create->/act-flutter-create
Deprecated aliases for older names may still exist for compatibility, but the act-* skill forms are the ones to use going forward.
Why this changed
Section titled “Why this changed”Moving from commands to skills makes ACT easier to carry across supported CLIs.
- Commands were tied more closely to one command surface.
- Skills are a more portable packaging model for the same kinds of workflows.
- Standardizing on
act-*also makes ACT-owned functionality easier to recognize and document.
What changed in practice
Section titled “What changed in practice”For most users, the migration means three things:
- If you previously used workflow commands such as
/act:workflow:spec, switch to the matching skill such as/act-workflow-spec. - If you previously used git or meta command wrappers such as
/act:git:commitor/act:meta:audit-work, switch to the matchingact-*skill. - If you previously used older ACT-owned skill names such as
/flutter-create, switch to theact-*version.
Timeline
Section titled “Timeline”| Change | What happened |
|---|---|
Before 0.4.0 | Most ACT functionality was documented and invoked as commands, with some ACT-owned skills still using older unprefixed names |
0.4.0 and later | Skills became the canonical interface for workflow, git, and meta features, and ACT-owned skills standardized on act-* naming |
Old skill names -> new skill names
Section titled “Old skill names -> new skill names”These old skill names are deprecated aliases. Use the act-* form going forward.
| Old | New |
|---|---|
/flutter-create | /act-flutter-create |
/dart-create | /act-dart-create |
/flutter-development | /act-flutter-development |
/flutter-drift-setup | /act-flutter-drift-setup |
/flutter-pub-upgrade-major | /act-flutter-pub-upgrade-major |
/flutter-robot-testing | /act-flutter-robot-testing |
/flutter-screenshot | /act-flutter-screenshot |
/flutter-sentry-init | /act-flutter-sentry-init |
/flutter-tdd | /act-flutter-tdd |
/git-worktree | /act-git-worktree |
/download-flutter-rules | /act-download-flutter-rules |
Workflow command wrappers -> workflow skills
Section titled “Workflow command wrappers -> workflow skills”| Old | New |
|---|---|
/act:workflow:spec | /act-workflow-spec |
/act:workflow:refine-spec | /act-workflow-refine-spec |
/act:workflow:plan | /act-workflow-plan |
/act:workflow:work | /act-workflow-work |
/act:workflow:compound | /act-workflow-compound |
Git command wrappers -> git skills
Section titled “Git command wrappers -> git skills”| Old | New |
|---|---|
/act:git:commit | /act-git-commit |
/act:git:commit-all | /act-git-commit-all |
/act:git:push-make-pr | /act-git-push-make-pr |
/act:git:switch-main-pull | /act-git-switch-main-pull |
Meta command wrappers -> meta skills
Section titled “Meta command wrappers -> meta skills”| Old | New |
|---|---|
/act:meta:audit-work | /act-meta-audit-work |
Removed prime command wrappers
Section titled “Removed prime command wrappers”Use these skill forms instead:
| Old | Use instead |
|---|---|
/act:prime-official-rules | /act-flutter-development official |
/act:prime-patterns-lite | /act-flutter-development lite |
/act:prime-patterns-full | /act-flutter-development full |
What still remains command-based
Section titled “What still remains command-based”These are still documented as commands rather than direct skills:
/act-help/act-update/act-update-changelog
What you should update
Section titled “What you should update”If you have saved snippets, personal notes, prompts, templates, or shell aliases, update them to the canonical names above.
Prioritize these replacements first:
- Replace all
/act:workflow:*usage with/act-workflow-* - Replace all
/act:git:*usage with/act-git-* - Replace any old unprefixed skill names with
act-* - Replace any saved
/act:prime-*usage with/act-flutter-development official|lite|full
Docs impact
Section titled “Docs impact”The docs site now treats these pages as canonical skill docs: