30 lines
914 B
Markdown
30 lines
914 B
Markdown
# Authoring Guide
|
|
|
|
## Choose The Right Primitive
|
|
|
|
- Use a skill for reusable multi-step workflows, especially if the workflow
|
|
should work in Copilot CLI as well as VS Code.
|
|
- Use a prompt for a lightweight VS Code slash command.
|
|
- Use an instruction file for conventions or rules that should influence model
|
|
behavior.
|
|
- Use an agent for a reusable persona with tool restrictions or handoffs.
|
|
- Use a hook only when the behavior must be deterministic and enforced in code.
|
|
|
|
## Supported Creation Paths
|
|
|
|
### Repo-first
|
|
|
|
Open this repository in VS Code and create the resource directly in the matching
|
|
folder.
|
|
|
|
### Local-first
|
|
|
|
Create the resource from a normal VS Code workspace or user-profile flow, then
|
|
publish it into this repository with `install/publish.sh` or
|
|
`install/publish.ps1`.
|
|
|
|
## Rule Of Record
|
|
|
|
If a resource is meant to be shared, the version in this repository is the only
|
|
version that counts.
|