skill-repo-manager - SKILL.md Agent Skill

name: skill-repo-manager description: "Use when working with the davis-llm-skill repository itself: adding skills, syncing them into ~/.codex/skills, preparing multi-client adapters, reviewing drift, or resolving conflicts between the repo copy and deployed copies."

Use this skill when the task is about maintaining the shared skill repository, not about executing one domain skill.

Treat ~/project/davis-llm-skill/skills/ as the canonical source for tracked skills.
Treat ~/.codex/skills/ as a deployed location for Codex.
Prefer editing the repository copy first, then sync outward.

Identify whether the task is repo authoring, repo -> Codex sync, or conflict resolution.
Before syncing, inspect whether the deployed target already differs from the repo copy.
If there is drift, do not overwrite silently. Review the diff and decide which side wins.
Use scripts/sync_codex_skill.sh <skill-name> for one skill or scripts/sync_codex_skill.sh --all for a full sync.
Only use --force after reviewing differences and deciding the repo is authoritative.
After sync, tell the user whether Codex needs a restart to pick up new or changed skills.
When shared skill text changes, regenerate Copilot adapters with scripts/generate_adapters.py --all before committing.

If the repo copy changed and the deployed copy also changed, stop and compare them.
Do not merge by guesswork when both sides have meaningful edits.
If the user wants local edits preserved, port them back into the repo before syncing.
If the repo should overwrite local copies, use --force explicitly and say that the deployed copy was replaced.

Keep reusable workflow logic in repository files, not hidden in one installed client.
Codex consumes skills/<name>/.
Copilot CLI and VS Code Copilot should get generated adapters instead of reusing Codex files verbatim.
When adding a new adapter, preserve the same workflow semantics and note any client-specific limits.
For shared-first skills such as context7-docs, update shared/<skill-name>/ first, then port the change to skills/<skill-name>/ and the client adapters.

When adding or updating a cross-platform skill:

Update the shared source under shared/<skill-name>/.
Update the Codex skill under skills/<skill-name>/.
Update Copilot CLI files under adapters/copilot-cli/<skill-name>/.
Update VS Code Copilot files under adapters/vscode-copilot/<skill-name>/.
Sync the Codex copy into ~/.codex/skills if the installed version should change.
Regenerate adapters if the shared source is authoritative.

Repo root: /home/davisye/project/davis-llm-skill
Codex deploy target: /home/davisye/.codex/skills
Sync script: /home/davisye/project/davis-llm-skill/scripts/sync_codex_skill.sh
Adapter generator: /home/davisye/project/davis-llm-skill/scripts/generate_adapters.py
New-machine installer: /home/davisye/project/davis-llm-skill/scripts/install_codex_skills.sh