autonomic-bot
f283a371bb
Sanitized single-commit public mirror of recipe-maintainer. - Removed test-ssh/.testenv (live creds); added test-ssh/.testenv.example placeholders. - Removed plans/ and planned-updates/ (deployment-planning docs) so no client/ deployment domains appear in the public repo. - All other secret stores were already gitignored. - docs.coopcloud.tech retained as a submodule (public upstream).
2.9 KiB
2.9 KiB
Skills and Commands
This project has skills and commands that work across both Claude Code and OpenCode.
Architecture
The single source of truth for all skill/command instructions is .claude/commands/. Both Claude Code and OpenCode use the same underlying instructions with no content duplication.
.claude/commands/ <-- Full instructions (single source of truth)
recipe-check.md
recipe-init.md
recipe-deploy.md
...
includes/
guidelines.md <-- Shared guidelines for all recipe operations
logging.md <-- Shared logging instructions
.opencode/skills/<name>/SKILL.md <-- Thin stubs that point to .claude/commands/
.opencode/commands/<name>.md <-- Thin stubs that load the corresponding skill
- Claude Code uses
.claude/commands/directly as slash commands (e.g./recipe-check hedgedoc). - OpenCode discovers skills via
.opencode/skills/and slash commands via.opencode/commands/. Each stub reads the full instructions from.claude/commands/at runtime.
Available skills and commands
| Name | Description |
|---|---|
recipe-check |
Fetch a recipe and check for available upgrades |
recipe-init |
Create a new test instance and recipe-info for a recipe |
recipe-deploy |
Deploy the local recipe checkout to the test instance |
recipe-new-tag |
Bump the recipe version and create an annotated git tag |
recipe-overview |
Check all maintained recipes and recommend what to upgrade |
recipe-review |
Review a recipe for Co-op Cloud best practices |
recipe-test |
Run all tests for a recipe |
recipe-test-new |
Test a recipe's first-time initialization from scratch |
recipe-test-update |
Test upgrading a recipe's test instance |
recipe-backup-test |
Test backing up and restoring a recipe's test instance |
recipe-upgrade |
Upgrade a recipe's images, deploy to test, and run tests |
test-context-reset |
Undeploy all apps from the test server except infrastructure |
Two additional skills provide shared instructions loaded by the above:
| Name | Description |
|---|---|
recipe-guidelines |
Guidelines for local change preservation, version format, secrets |
recipe-logging |
Logging instructions for maintaining detailed operation logs |
Adding or editing skills
To add a new skill or edit an existing one:
- Write the full instructions in
.claude/commands/<name>.md(this is the source of truth). - Create a stub at
.opencode/skills/<name>/SKILL.mdwith the required frontmatter (name,description) and a line pointing to the.claude/commands/file. - Create a stub at
.opencode/commands/<name>.mdwith frontmatter (description) and a line that loads the skill for$ARGUMENTS.
The OpenCode stubs should never contain substantive instructions — only a pointer to the .claude/commands/ file.