skill-author
Scaffolds a new skill profile in this repo and fills in the required SKILL.md structure when a contributor wants to add a skill.
- License 许可
- MIT
- 最近更新
- 2026-11-09
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- skill-author
- tags
- [ "meta", "skills" ]
- owner
- bcgov
- source
- https://github.com/bcgov/agent-skills
- license
- MIT
- metadata
- { "internal": true }
- description
- Scaffolds a new skill profile in this repo and fills in the required SKILL.md structure when a contributor wants to add a skill.
- imported_at
- 2026-09-20
- source_path
- .github/skills/skill-author/SKILL.md
- source_repository
- bcgov/agent-skills
03 SKILL.md 正文
Skill Author
Use When
- The user wants to add a brand-new skill to this repo.
- The user asks how to start, scaffold, or structure a
SKILL.md. - The user has an idea for a skill but doesn't know the required layout.
Don't Use When
- The user wants to check an existing skill against the spec → use
skill-validator. - The user is editing prose in an existing, already-structured skill.
Workflow
- Before scaffolding, confirm no upstream catalogue already covers this use case. Search The Agent Skills Directory, the Microsoft Agent Skills catalog,
anthropics/skills, andgithub/awesome-copilot. If an upstream skill covers it, point the user there instead of scaffolding a duplicate; only proceed when the skill is genuinely BC Gov–specific (encodes BC Gov policies, internal services, regulatory requirements, or org-specific workflows). - Pick a kebab-case
<skill-name>and createskills/<skill-name>/. - Create
skills/<skill-name>/SKILL.md. Either copy an existing skill'sSKILL.mdas a starting point (e.g.skills/azure-networking/SKILL.md) and rewrite the content, or write from scratch usingspec/SKILL_SPEC.mdas the structural reference. - Fill the frontmatter (
name,description) and write the H1 title line. - Complete all seven sections: Use When, Don't Use When, Workflow, Rules, Examples, Edge Cases, References.
- Run
uv run python scripts/validate_skill.py skills/<skill-name>/SKILL.mdand fix any errors.
Rules
- Always run the upstream-catalogue check in Workflow step 1 before scaffolding. (Why: this repo is for BC Gov–specific skills; duplicating an upstream skill fragments the ecosystem, doubles the maintenance burden, and makes it ambiguous which one consumers should install. Reviewers will ask for the result of this check in the PR description.)
- Never invent a new section order or rename a section. (Why: the validator matches the seven section titles exactly and the PR check will fail.)
- Always keep
## Use Whenas situational triggers (when to reach for this skill at all) and## Workflowas the numbered procedure (how to do the work). Never let a Use When bullet paraphrase a Workflow step — if a bullet starts with "Always ship…", "Set X to Y", or restates a procedural detail, it belongs in Workflow, not Use When. (Why: the two sections serve different reader intents — routing vs. execution — and duplicating content between them bloats the agent's context, makes routing fuzzier, and drifts out of sync on every edit.)
Examples
- "I want to add a skill for looking up land parcels" → scaffold
skills/parcel-lookup/, fill the template, validate. - "How do I start a new skill profile?" → copy the template into a new skill dir and walk through the seven sections.
Edge Cases
- If a
skills/<skill-name>/folder already exists → confirm whether to edit it (route to the author flow on the existing files) rather than overwriting. - If the user hasn't named the skill → propose a kebab-case name from the described purpose before scaffolding.
References
For the upstream-catalogue check in step 1, search The Agent Skills Directory, Microsoft Agent Skills, anthropics/skills, and github/awesome-copilot; the "Before adding a new skill" section of CONTRIBUTING.md explains the policy in full.
See spec/SKILL_SPEC.md for the authoritative manifest spec.
04 同仓库更多 Skills
dei-assessment
Assess diversity, equity, and inclusion with metrics. TRIGGERS - Use when user needs help with dei-assessment related tasks.
dei-action-plan
Create DEI action plans with goals and initiatives. TRIGGERS - Use when user needs help with dei-action-plan related tasks.
culture-fit-assessment
Design culture add assessment processes. TRIGGERS - Use when user needs help with culture-fit-assessment related tasks.
cowork-to-code-bridge
Use an already-installed, independently verified cowork-to-code bridge to run narrowly approved actions on the user's own macOS, Linux, or WSL2 machine through a local file queue.
counter-offer-response
Draft counter-offer responses for retention. TRIGGERS - Use when user needs help with counter-offer-response related tasks.
continuous-feedback-system
Design continuous feedback systems. TRIGGERS - Use when user needs help with continuous-feedback-system related tasks.