Repository navigation
docs(assess): clarify README invocation guidance - #5068
WOLIKIMCHENG wants to merge 2 commits into
Conversation
Assisted-by: OpenAI Codex (model: gpt-6.1-sol, autonomous)
There was a problem hiding this comment.
🟡 Changes recommended
The README edit lacks the synchronized extension version updates enforced by CI.
1 open issue
What changed in this PR
Clarifies how to invoke the assess extension across agent integrations while preserving its five-stage workflow and optional handoff.
Changes:
- Distinguishes canonical command IDs from integration-specific syntax and links to invocation guidance.
- Labels the example as GitHub Copilot’s default skills mode and updates it to use hyphenated skill names in agent chat.
| File | Description |
|---|---|
extensions/assess/README.md |
Clarifies invocation syntax and updates the Copilot chat example. |
Review effort: Max
| | `speckit.assess.shape` | Shape 2–3 concept-level options with appetite and trade-offs; recommend one (or none). | `concept.md` | | ||
| | `speckit.assess.decide` | Score against criteria and render the verdict; hand `go` ideas to `/speckit.specify`. | `decision.md` | | ||
|
|
||
| The table lists canonical command IDs. Dotted `/speckit.*` references in this README identify commands; the invocation depends on your integration and installed mode. For example, intake is `/speckit-assess-intake` in GitHub Copilot's default skills mode, `$speckit-assess-intake` in Codex skills mode, and `/skill:speckit-assess-intake` in Kimi. Use the form exposed by your agent; see [Command invocation](https://github.github.io/spec-kit/integrations/cli.html#command-invocation) and [Copilot's commands layout](https://github.github.io/spec-kit/integrations/copilot.html#commands-layout). |
|
Thanks for clarifying the invocation guidance. Please align the assessment README with the main README: use GitHub Copilot’s default skills syntax throughout, including the command table, examples, and handoff references, rather than retaining dotted command IDs or listing other agents’ syntax variations. Use the same wording as the main README:
This keeps the README focused on one consistent syntax and leaves integration-specific variations in the shared reference. Please retain the clarification that skills run in the agent’s chat, not the terminal. |
Assisted-by: OpenAI Codex (model: gpt-6.1-sol, autonomous)
|
Thanks for the guidance. Updated the assess README to use GitHub Copilot's default skills syntax throughout, retained the agent-chat guidance, and bumped the assess extension, catalog entry, and bundle pin to 1.0.2 in commit |

Description
Use GitHub Copilot's default skills syntax throughout the assess README, including the command table, examples, and handoff references. Match the main README's invocation guidance and retain the instruction to run skills in the agent's chat, not the terminal.
Bump the assess extension to 1.0.2 and synchronize its catalog entry and bundle extension pin. The five stages and optional handoff remain unchanged.
Testing
git diff --checkpassed.AI Disclosure
AI disclosure: AI-assisted tools were used to update the assess README and version metadata and verify the changes.