Hello, I always appreciate rulesync.
Problem
Two Copilot-specific behaviors exist in the implementation but are not mentioned in any documentation.
Issue 1: CopilotSkill throws on global mode
In src/features/skills/copilot-skill.ts around line 74–76:
throw new Error("CopilotSkill does not support global mode.");
Users who attempt rulesync generate --targets copilot --features skills in global mode will receive an error with no prior warning or documentation explaining this constraint.
Issue 2: Non-root rule files use .instructions.md double extension
Non-root Copilot rules are generated as .github/instructions/<name>.instructions.md. The double .instructions.md extension is a GitHub Copilot convention, but this is not explained anywhere in the docs. Users unfamiliar with this convention may be confused by the generated filenames.
Proposed Solution
Both limitations should be documented in the dedicated Copilot page (once created) or in docs/reference/supported-tools.md:
- Add a note that
skills feature is not available in global mode for copilot
- Explain the
.instructions.md naming convention and its origin
Your consideration would be appreciated.
Hello, I always appreciate rulesync.
Problem
Two Copilot-specific behaviors exist in the implementation but are not mentioned in any documentation.
Issue 1: CopilotSkill throws on global mode
In
src/features/skills/copilot-skill.tsaround line 74–76:Users who attempt
rulesync generate --targets copilot --features skillsin global mode will receive an error with no prior warning or documentation explaining this constraint.Issue 2: Non-root rule files use
.instructions.mddouble extensionNon-root Copilot rules are generated as
.github/instructions/<name>.instructions.md. The double.instructions.mdextension is a GitHub Copilot convention, but this is not explained anywhere in the docs. Users unfamiliar with this convention may be confused by the generated filenames.Proposed Solution
Both limitations should be documented in the dedicated Copilot page (once created) or in
docs/reference/supported-tools.md:skillsfeature is not available in global mode forcopilot.instructions.mdnaming convention and its originYour consideration would be appreciated.