hecaguilav/symbiosis/docs-alignment

Claude Code and agent skill by hecaguilav/symbiosis

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Install

npx vskill@latest install hecaguilav/symbiosis/docs-alignment

SKILL.md

The same SKILL.md was published earlier as gentleman-programming/gentleman-guardian-angel/docs-alignment.

Skill: gga-docs-alignment

Purpose

Keep documentation in sync with every code and workflow change in GGA.

When to Use

Any code or workflow change that affects user or contributor behavior.

Docs Map

FileCovers
README.mdInstallation, usage, CLI flags, providers, examples
CONTRIBUTING.mdDev setup, contribution workflow, labels, testing, PR process

Change → Doc Rules

If you change...Update...
A CLI flag (add, remove, rename)README.md — flags table + examples
A provider (add, remove, change behavior)README.md + CONTRIBUTING.md
The contribution workflowCONTRIBUTING.md
The label systemCONTRIBUTING.md
Test structure or test commandsCONTRIBUTING.md
Install/uninstall behaviorREADME.md
The .gga config formatREADME.md
Hook behavior or marker formatREADME.md + CONTRIBUTING.md
CI mode behavior (--ci)README.md

Critical Rules

  • NEVER reference CLI flags, commands, or scripts that don't exist in code
  • NEVER let a PR that changes behavior ship without updating docs
  • Docs must describe the FINAL state, not the journey ("now supports X" is wrong)
  • Code examples in docs must be tested and accurate
  • PRs that change behavior without updating docs should be rejected in review

Verification Checklist

Before submitting a PR with code changes:

[ ] Does this change affect any CLI flags? → update README.md
[ ] Does this change affect provider behavior? → update README.md + CONTRIBUTING.md
[ ] Does this change affect the contribution
workflow or labels? → update CONTRIBUTING.md
[ ] Does this add/remove a config option? → update README.md
[ ] Are all code examples in the docs still
accurate after this change? → verify manually

Anti-patterns

# BAD — README still shows old flag name
README: --cache-dir
Code: --cache-path ← was renamed
# BAD — docs reference non-existent script
README: "run setup.sh to configure" ← setup.sh doesn't exist
# BAD — missing provider in list
README: "Supports: Claude, Gemini, Codex" ← Ollama was just added but not listed

Cookbook

If...Then...
Adding a new providerAdd it to README providers table + CONTRIBUTING dev setup
Renaming a CLI flagSearch README for old flag name, update all occurrences
Changing PR workflowUpdate CONTRIBUTING.md contribution steps section
Adding a new make targetAdd to CONTRIBUTING.md development commands

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/hecaguilav/symbiosis/docs-alignment/badge)](https://verified-skill.com/skills/hecaguilav/symbiosis/docs-alignment)

Something wrong with this skill or its page? Tell us.