Skill Scope
Goal
Resolve skill origin and edit ownership without confusing installed global skills with project-local skills.
Workflow
- Run
scripts/skill-scope list --project "$PWD"to inventory both scopes. - Project-local skills are only
.opencode/skills/<name>and.agents/skills/<name>beneath the current repository. - Global installed skills are runtime views; the editable source is
OPENCODE_GLOBAL_SKILLS_CHECKOUT, falling back to~/Documents/AI/skillsfor this owner environment. - For creation, require
--scope local|global. Never infer global merely because an installed skill exists. - Use
skill-editfor validation, tests, and publishing after ownership is resolved.
Rules
- Never edit Nix store paths or generated runtime adapters.
- Prefer local scope when a workflow belongs to one project.
- Use global scope only for genuinely reusable workflows or explicit requests.
- Report the origin path with every listed skill.