docs: document copilot skills mode (--skills) and markdown deprecation#3313
Open
Quratulain-bilal wants to merge 1 commit into
Open
docs: document copilot skills mode (--skills) and markdown deprecation#3313Quratulain-bilal wants to merge 1 commit into
Quratulain-bilal wants to merge 1 commit into
Conversation
as of github#3256 (v0.12.3) the copilot integration supports a skills mode via `--integration-options "--skills"`, and installing without it warns that the legacy markdown default is being phased out. this was undocumented: - the copilot row in the supported-agents table had an empty notes cell while other skills-capable agents describe their behavior there. - `--skills` was missing from the integration-specific options table (only generic and kimi were listed). fill both. wording matches the code: skills scaffold as speckit-<name>/SKILL.md under .github/skills/ and are invoked as /speckit-<name>; without the flag the install emits the deprecation warning from _warn_legacy_markdown_default(). fixes github#3300
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.
fixes #3300
as suggested by @mnriem on the issue.
what
the copilot skills mode (added in #3256, v0.12.3) wasn't documented in
docs/reference/integrations.md:--skillswas missing from the integration-specific options table — onlygenericandkimiwere listed.how
.agent.mdby default;--integration-options "--skills"scaffoldsspeckit-<name>/SKILL.mdunder.github/skills/; the markdown default is deprecated.copilot/--skillsrow to the integration-specific options table.verified against the code
CopilotIntegration.options()insrc/specify_cli/integrations/copilot/__init__.pydefines--skillsas a flag with help "Scaffold commands as agent skills (speckit-/SKILL.md) instead of .agent.md files".dispatch_commanduses.github/skills/,speckit-<stem>/SKILL.md, and invokes/speckit-<stem>in skills mode;--agent speckit.<stem>otherwise._warn_legacy_markdown_default()emits the deprecation warning when installing without--skills.docs-only change.
note: i used an ai assistant to help investigate and write this up.