/promote
Promote or graduate a project-local bundle to its upstream AIWG location or to a private corpus path.
Claude Code
$ npx -y skills add jmagly/aiwg --skill promote --agent claude-code
Codex
$ npx skills add jmagly/aiwg --skill promote -a codex -y
Cursor
$ npx skills add jmagly/aiwg --skill promote -a cursor -y
Gemini CLI
$ npx skills add jmagly/aiwg --skill promote -a gemini-cli -y
GitHub Copilot
$ npx skills add jmagly/aiwg --skill promote -a github-copilot -y
OpenCode
$ npx skills add jmagly/aiwg --skill promote -a opencode -y
Windsurf
$ npx skills add jmagly/aiwg --skill promote -a windsurf -y
SKILL.md
promote.SKILL.mdnamespace: aiwg name: promote platforms: [all] description: Promote or graduate a project-local bundle to its upstream AIWG location or to a private corpus path. triggers: - promote bundle - promote project-local - graduate project-local bundle - graduate to upstream - project-local bundle
Promote Project-Local Bundle
Graduate a proven project-local bundle without losing its source provenance.
Behavior
1. Identify the project-local bundle and its intended destination. 2. Preview the copy and registry transition:
aiwg promote <name> --dry-run
3. Promote to the declared upstream location or a private corpus:
aiwg promote <name> --to upstream aiwg promote <name> --to corpus <path>
4. Use `--cleanup` only when the project-local source should be removed after successful promotion. Use `--force` only after reviewing a destination conflict.
Safety
- Run `aiwg doctor` and a dry run before promotion.
- Promotion verifies the bundle manifest and destination before copying.
- Omit `--cleanup` to retain the project-local source.
References
- @$AIWG_ROOT/src/cli/handlers/subcommands.ts — `promote` command handler
- @$AIWG_ROOT/src/extensions/project-local-promote.ts — promotion implementation
- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/skills/steward-quickref/SKILL.md
Reusable project context and specialist workflows for the AI tools you already use. Plan software, coordinate specialist reviews, prepare campaigns, investigate incidents, organize research, curate media, and maintain operational knowledge.
Other skills on aiwg.
More skills from other plugins.
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
ask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
Questions about promote.
- Which coding agents can use promote?
- promote installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.

