VeryGoodOpenSource / VeryGoodOpenSource/vgv-ai-flutter-plugin
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
- 162
- Forks
- 23
- Avg merge
- 2d 22h
- Merged PRs (30d)
- 4
Description
Description
Phase 0 of the open-standard epic #51 — make the skills portable before publishing (#50) and before wiring tier-2 harnesses (#46 Codex, #125 Gemini CLI). Blocks the rest of the epic.
Workstreams
- Guard MCP references — skill bodies reference
mcp__dart__*andvery-good-clitools. Ensure they degrade gracefully (clear fallback instructions) where MCP is absent, so skills stay useful on harnesses without those servers. - Namespacing + collision audit — flatten skill names to kebab-case under
.agents/skills/; audit for cross-plugin collisions withvgv-wingspan; prefixvgv-where needed. - Argument / path fallbacks — add symptom-described fallbacks for
$ARGUMENTSand${CLAUDE_SKILL_DIR}so bodies survive hosts that do not substitute them (describe the symptom, never name the token, or Claude Code substitutes it inside the explanation). - Hook adaptation groundwork — factor the enforcement hook scripts so they can be re-pointed to Codex (
hooks.json/[hooks]) and Gemini CLI (Claude-hook migration) with minimal per-host divergence. OpenCode uses a JS/TS plugin API rather than the Claude shell contract, so its hook is a separate rewrite — keep the enforcement logic isolated enough to reimplement. - Reserved slash-command collision audit — check skill names against Codex, Gemini CLI, and OpenCode built-in commands (precedent: Copilot's built-in
/review). - 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,allowed-tools,argument-hint, etc.) are ignored rather than fatal. Add a CI lint that fails on malformed frontmatter so skills never vanish silently.
Requirements
- MCP references degrade gracefully where MCP absent
- Skill names flat kebab-case, no cross-plugin collisions
-
$ARGUMENTS/${CLAUDE_SKILL_DIR}fallbacks in place - Hook scripts factored for multi-host adaptation
- Reserved-command collision audit complete for Codex + Gemini CLI
- Every SKILL.md parses on Codex + Gemini; CI lint fails on malformed frontmatter
- All CI/CD checks are passing.
- There is no drop in the test coverage percentage.
Additional Context
Part of epic #51. Blocks #50, #46, #125.
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.