feat(skill): resolve gemini/copilot install paths + quarterly convention re-check#112
Merged
Merged
Conversation
…ion re-check Gemini and GitHub Copilot CLI both confirmed (2026-06-25) user-scoped Skill paths: ~/.gemini/skills/<name>/SKILL.md and ~/.copilot/skills/<name>/SKILL.md (both also accept the agent-neutral ~/.agents/skills/ interop alias). The gemini/copilot resolvers now return a real path instead of manual instructions. Adds .github/workflows/skill-convention-review.yml: a quarterly scheduled job that opens a tracking issue to re-check the four canonical convention URLs. Closes #7 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #7
What
A 2026-06-25 drift re-check flipped two platform Skill-install conventions from MANUAL to confirmed:
~/.gemini/skills/<name>/SKILL.md(source: https://geminicli.com/docs/cli/skills/)~/.copilot/skills/<name>/SKILL.md(source: https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills)Both CLIs also accept the agent-neutral
~/.agents/skills/interop alias.Changes
nsc/cli/skill_commands.py:_resolve_gemini/_resolve_copilotnow return a realpath(with a WHY comment citing the source URL +confirmed 2026-06-25), mirroring the claude-code/codex resolvers. claude-code and codex unchanged.tests/cli/test_skill_commands.py: gemini/copilot now assert a resolved path + that--applywrites the SKILL.md to the new sandboxed$HOMEpath; the old MANUAL JSON case became a parametrized non-manual assertion.docs/guides/using-with-ai-agents.md: per-target table now lists both confirmed paths and the~/.agents/skills/interop alias.skills/netbox-super-cli/SKILL.md: no per-target install path table, left as-is.CHANGELOG.md: entry under existing## v1.3.0 — unreleased+[#7]link def..github/workflows/skill-convention-review.yml(core Phase 6: track per-platform Skill install convention drift #7 deliverable): quarterly cron (Feb/May/Aug/Nov) +workflow_dispatch, least-privilegepermissions: { contents: read, issues: write }, single job thatgh issue creates a tracking issue with the four canonical URLs and the update checklist. No third-party actions, no SHA pins needed.Verification
just lint→ ruff +mypy --strict: all green.just test→ 1148 passed, 1 skipped.yaml.safe_load).🤖 Generated with Claude Code