feat: add Opencode IDE integration with 13 AIOX agent skills#806
feat: add Opencode IDE integration with 13 AIOX agent skills#806RicSchonfelder wants to merge 1 commit into
Conversation
- Add .opencode/skills/ with 13 AIOX agent SKILL.md files for opencode - Add opencode section to docs/ide-integration.md with setup instructions - Add opencode to sync system diagram, auto-sync config, and troubleshooting - Add .opencode/skills/ to package.json files for npm distribution - Add sync:ide:opencode npm script
|
@RicSchonfelder is attempting to deploy a commit to the SINKRA - AIOX Team on Vercel. A member of the Team first needs to authorize it. |
|
Welcome to aiox-core! Thanks for your first pull request. What happens next?
PR Checklist:
Thanks for contributing! |
WalkthroughAdds OpenCode support through AIOX core documentation, 12 agent skill definitions, IDE integration guidance, packaging, and a dedicated synchronization script. ChangesOpenCode integration
Estimated code review effort: 2 (Simple) | ~10 minutes Suggested labels: Suggested reviewers: 🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🧹 Nitpick comments (2)
.opencode/skills/aiox-core/SKILL.md (2)
21-25: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low valueSpecify language for fenced code blocks.
To improve syntax highlighting and comply with markdown linting rules, please specify a language identifier for these fenced code blocks (e.g.,
bashortext).Also applies to: 47-52, 55-57
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In @.opencode/skills/aiox-core/SKILL.md around lines 21 - 25, Update the fenced code blocks in the aiox-core SKILL documentation, including the blocks around the command examples and the additional referenced sections, to include an appropriate language identifier such as bash or text. Preserve the commands and their formatting.Source: Linters/SAST tools
36-36: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low valueHyphenate compound adjective.
Consider hyphenating "Full stack" to "Full-stack" when it modifies a noun.
📝 Proposed fix
-| `aiox-dev` | Full stack developer — implementation | `task` subagent | +| `aiox-dev` | Full-stack developer — implementation | `task` subagent |🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In @.opencode/skills/aiox-core/SKILL.md at line 36, Update the `aiox-dev` role description in the skills table to hyphenate “Full-stack” when it modifies “developer,” leaving the surrounding role and subagent entries unchanged.Source: Linters/SAST tools
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.opencode/skills/aiox-devops/SKILL.md:
- Around line 1-4: Remove the unsupported slash metadata field from the
frontmatter of .opencode/skills/aiox-devops/SKILL.md,
.opencode/skills/aiox-master/SKILL.md, .opencode/skills/aiox-pm/SKILL.md,
.opencode/skills/aiox-po/SKILL.md, .opencode/skills/aiox-qa/SKILL.md,
.opencode/skills/aiox-sm/SKILL.md, and
.opencode/skills/aiox-squad-creator/SKILL.md; leave each skill’s name and
description metadata unchanged.
---
Nitpick comments:
In @.opencode/skills/aiox-core/SKILL.md:
- Around line 21-25: Update the fenced code blocks in the aiox-core SKILL
documentation, including the blocks around the command examples and the
additional referenced sections, to include an appropriate language identifier
such as bash or text. Preserve the commands and their formatting.
- Line 36: Update the `aiox-dev` role description in the skills table to
hyphenate “Full-stack” when it modifies “developer,” leaving the surrounding
role and subagent entries unchanged.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Run ID: 865ac449-bbda-43f6-b50f-e8a35c8f754f
📒 Files selected for processing (15)
.opencode/skills/aiox-analyst/SKILL.md.opencode/skills/aiox-architect/SKILL.md.opencode/skills/aiox-core/SKILL.md.opencode/skills/aiox-data-engineer/SKILL.md.opencode/skills/aiox-dev/SKILL.md.opencode/skills/aiox-devops/SKILL.md.opencode/skills/aiox-master/SKILL.md.opencode/skills/aiox-pm/SKILL.md.opencode/skills/aiox-po/SKILL.md.opencode/skills/aiox-qa/SKILL.md.opencode/skills/aiox-sm/SKILL.md.opencode/skills/aiox-squad-creator/SKILL.md.opencode/skills/aiox-ux-expert/SKILL.mddocs/ide-integration.mdpackage.json
| --- | ||
| name: aiox-devops | ||
| description: "Gage — AIOX DevOps Specialist. CI/CD, version management, quality gates, repository operations." | ||
| slash: true |
There was a problem hiding this comment.
🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win
🧩 Analysis chain
🏁 Script executed:
#!/bin/bash
# Verify all OpenCode skill files contain the unsupported field.
rg -n '^slash:\s*true$' .opencode/skillsRepository: SynkraAI/aiox-core
Length of output: 832
🏁 Script executed:
#!/bin/bash
set -euo pipefail
echo "== skill file inventory =="
git ls-files '.opencode/skills/*/SKILL.md'
echo
echo "== search for slash handling =="
rg -n --hidden --glob '!**/.git/**' '\bslash\b' .opencode . | head -200
echo
echo "== inspect skill docs/readme references =="
rg -n --hidden --glob '!**/.git/**' 'OpenCode|skills' README.md .opencode 2>/dev/null | head -200Repository: SynkraAI/aiox-core
Length of output: 17122
🏁 Script executed:
#!/bin/bash
set -euo pipefail
echo "== map the main skill docs =="
fd -t f -a 'SKILL.md|README.md|*.md' .opencode | sed -n '1,200p'Repository: SynkraAI/aiox-core
Length of output: 508
🏁 Script executed:
#!/bin/bash
set -euo pipefail
python3 - <<'PY'
from pathlib import Path
for p in Path('.opencode/skills').glob('*/SKILL.md'):
text = p.read_text()
if 'slash:' in text:
print(p)
PYRepository: SynkraAI/aiox-core
Length of output: 650
🌐 Web query:
OpenCode skills frontmatter slash field supported documented skill metadata fields
💡 Result:
In OpenCode, skills defined by SKILL.md files use YAML frontmatter to provide metadata for agent discoverability and behavior [1][2]. While the "slash field" terminology is not standard documentation, users often refer to the metadata fields used to control skills or custom commands invoked via a slash command (e.g., /skill-name) [3][4]. The officially documented and recognized YAML frontmatter fields for SKILL.md files are [1][5]: - name (Required): A unique identifier for the skill, which must match the directory name where the SKILL.md file is stored (format: lowercase-hyphen) [6][5]. - description (Required): A detailed description of the skill's purpose, used as the primary signal for agent discovery [6][5]. - license (Optional): An identifier for the license (e.g., MIT, Apache-2.0) [6][5]. - compatibility (Optional): An open-ended string indicating compatibility (e.g., opencode) [5]. - metadata (Optional): A key-value map (Record<string, string>) used to store arbitrary custom metadata [6][2][5]. For custom slash commands (which are separate from but related to the skill system), additional fields like agent and model have been observed in usage and issues, though behavior can vary by version [7][3]. Some community discussions have referenced interest in aligning OpenCode skill frontmatter with broader standards (such as those used by similar tools) to support advanced features like disable-model-invocation or user-invocable controls, though these are not part of the standard SKILL.md schema documentation [4]. Any unknown or undocumented fields provided in the frontmatter are ignored by the OpenCode skill parser [1][8][9].
Citations:
- 1: https://open-code.ai/en/docs/skills
- 2: https://deepwiki.com/malhashemi/opencode-skills/3-skill-specification
- 3: https://www.opencodebook.xyz/en/chapter_14_skill_system/14.3_command_system
- 4: OpenCode started listing skills as commands with no option to disable this behavior anomalyco/opencode#12109
- 5: https://github.com/wesammustafa/OpenCode-Everything-You-Need-to-Know/blob/main/docs/skills.md
- 6: https://deepwiki.com/malhashemi/opencode-skills/3.2-frontmatter-schema
- 7: 'model' field in slash command appears to be ignored [Version: 0.6.4] anomalyco/opencode#2461
- 8: https://github.com/sst/opencode/blob/dev/packages/web/src/content/docs/skills.mdx
- 9: https://frank.dev.opencode.ai/docs/skills/
Remove slash: true from these skill frontmatters. OpenCode ignores unknown skill metadata, so this field won’t make the skills available as slash commands. The same applies to the other listed skill files.
📍 Affects 7 files
.opencode/skills/aiox-devops/SKILL.md#L1-L4(this comment).opencode/skills/aiox-master/SKILL.md#L1-L4.opencode/skills/aiox-pm/SKILL.md#L1-L4.opencode/skills/aiox-po/SKILL.md#L1-L4.opencode/skills/aiox-qa/SKILL.md#L1-L4.opencode/skills/aiox-sm/SKILL.md#L1-L4.opencode/skills/aiox-squad-creator/SKILL.md#L1-L4
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In @.opencode/skills/aiox-devops/SKILL.md around lines 1 - 4, Remove the
unsupported slash metadata field from the frontmatter of
.opencode/skills/aiox-devops/SKILL.md, .opencode/skills/aiox-master/SKILL.md,
.opencode/skills/aiox-pm/SKILL.md, .opencode/skills/aiox-po/SKILL.md,
.opencode/skills/aiox-qa/SKILL.md, .opencode/skills/aiox-sm/SKILL.md, and
.opencode/skills/aiox-squad-creator/SKILL.md; leave each skill’s name and
description metadata unchanged.
1 participant
Summary
Adds full Opencode IDE support to the AIOX framework, including 13 agent skills and comprehensive documentation.
Changes
New: .opencode/skills/ directory (13 agent skills)
Each skill follows the SKILL.md format native to opencode.
Updated: docs/ide-integration.md
Updated: package.json
Summary by CodeRabbit
New Features
Documentation