VeryGoodOpenSource / VeryGoodOpenSource/vgv-wingspan
feat: Phase 0 portability prep for open-standard support
Open
@ryzizub is already working on this.
Since Jul 21, 2026.
feature
p1
- Dominant language
- Shell
- Stars
- 105
- Forks
- 15
- Avg merge
- 13h 12m
- Merged PRs (30d)
- 2
Description
Description
Phase 0 of the open-standard epic #66 — make the skills portable before publishing to skills.sh and before wiring tier-2 harnesses (Codex, Gemini CLI). Blocks the rest of the epic.
Workstreams
- Namespacing + collision audit — flatten skill names to kebab-case under
.agents/skills/; audit for cross-plugin collisions withvgv-ai-flutter-plugin; prefixvgv-where needed. Note the existing/review->quality-reviewrename from PR #220. - Argument / path fallbacks — the
$ARGUMENTSand${CLAUDE_SKILL_DIR}symptom-described fallbacks partly landed via PR #220; finish applying them across all skills so bodies survive hosts that do not substitute. - MCP references — only
context7; ensure skills that use it degrade gracefully where absent. - Reserved slash-command collision audit — check skill names against Codex, Gemini CLI, and OpenCode built-in commands (precedent: Copilot's built-in
/review). - Agent-definition format conversion — all three tier-2 harnesses support subagents, so the review/plan/research panels port rather than degrade. Define a single source for agent definitions and convert per host: md -> TOML for Codex (
~/.codex/agents/), md + YAML frontmatter for Gemini CLI (.gemini/agents), and markdown agents for OpenCode (mode: subagent) — the latter two are close to our currentagents/*.md. - SKILL.md frontmatter compatibility — Gemini CLI silently skips a SKILL.md if the frontmatter is not the first thing in the file, if
name/descriptionis missing, or if the---delimiters are off. Validate every skill parses on Codex + Gemini + OpenCode, and confirm our extra fields (when_to_use,user-invocable,disable-model-invocation,effort,argument-hint,allowed-tools) are ignored rather than fatal. Add a CI lint that fails on malformed frontmatter so skills never vanish silently.
Requirements
- Skill names flat kebab-case, no cross-plugin collisions
-
$ARGUMENTS/${CLAUDE_SKILL_DIR}fallbacks applied across all skills -
context7reference degrades gracefully where absent - Reserved-command collision audit complete for Codex + Gemini CLI
- Agent-definition format conversion defined (md -> TOML Codex, md+frontmatter Gemini, md agents OpenCode)
- Every SKILL.md parses on Codex + Gemini + OpenCode; CI lint fails on malformed frontmatter
Additional Context
Part of epic #66. Blocks the skills.sh, Codex, and Gemini CLI items.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.