skill-creator
Trigger: new skills, agent instructions, documenting AI usage patterns. Create LLM-first skills with valid frontmatter.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-15
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- skill-creator
- license
- Apache-2.0
- metadata
- { "author": "gentleman-programming", "version": "1.0" }
- description
- Trigger: new skills, agent instructions, documenting AI usage patterns. Create LLM-first skills with valid frontmatter.
03 SKILL.md 正文
Activation Contract
Create a skill when:
- A pattern is used repeatedly and AI needs guidance
- Project-specific conventions differ from generic best practices
- Complex workflows need step-by-step instructions
- Decision trees help AI choose the right approach
Do not create a skill when the pattern is trivial, one-off, or better served by normal documentation.
Hard Rules
- When working in this repo, first follow
docs/skill-style-guide.mdas the normative source before creating or updating skills. - If that guide is unavailable, use the compact inline rules below.
- A skill is a runtime instruction contract for an LLM, not human documentation.
- Do not add a
Keywordssection; preserve essential trigger words indescription. - References must point to local files.
- Keep the skill body concise: target 180–450 tokens, recommended max 700, hard max 1000.
Decision Gates
| Need | Action |
|---|---|
| Code templates, schemas, fixtures, generated examples | Put them in assets/ |
| Conceptual detail, edge cases, existing docs | Put local links in references/ |
Long explanation in SKILL.md |
Move it to a supporting file |
| Multiple meaningful paths | Add a compact decision table |
Execution Steps
- Check whether
docs/skill-style-guide.mdexists; if it does, apply it before the inline fallback rules. - Confirm the skill does not already exist and the pattern is reusable.
- Create or update
skills/{skill-name}/SKILL.mdusing this required structure:
skills/{skill-name}/
├── SKILL.md # Required - main skill file
├── assets/ # Optional - templates, schemas, examples
│ ├── template.py
│ └── schema.json
└── references/ # Optional - links to local docs
└── docs.md # Points to docs/developer-guide/*.mdx
- Use this frontmatter shape:
---
name: {skill-name}
description: "Trigger: {essential trigger words users or agents will say}. {What this skill does}."
license: Apache-2.0
metadata:
author: gentleman-programming
version: "1.0"
---
- Write sections in this order: Activation Contract, Hard Rules, Decision Gates, Execution Steps, Output Contract, References.
- Register the skill in
AGENTS.mdwhen it is a project skill.
Inline Fallback Rules
descriptionMUST be one physical line, quoted, YAML-safe, and include essential trigger words first.descriptionSHOULD be <=160 chars and MUST be <=250 chars.- Frontmatter MUST include
name,description,license,metadata.author, andmetadata.version. - Use imperative instructions, not tutorials or background prose.
- Put supporting material in
assets/orreferences/, not the main skill body.
Good:
description: "Trigger: Jira task, ticket, issue, task creation. Create Jira tasks in the team format."
Bad:
description: >
Create Jira tasks in the team format.
Trigger: Jira task, ticket, issue, or task creation.
Keywords: jira, task
Output Contract
Return:
- Files created or modified.
- Whether the repo style guide or inline fallback rules were used.
- Any AGENTS.md registration change.
- Any supporting files added under
assets/orreferences/.
References
docs/skill-style-guide.md— normative LLM-first skill style guide for this repo.
04 同仓库更多 Skills
invocable-skill
Run a security audit on the specified target. Use when asked to audit, scan, or assess security posture.
invocable-skill
Run a security audit on the specified target. Use when asked to audit, scan, or assess security posture.
work-unit-commits
Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code.
skill-registry
Trigger: update skills, skill registry, actualizar skills, after skill changes. Index available skills by trigger and path.
skill-improver
Trigger: improve skills, audit skills, refactor skills, skill quality. Audit and upgrade existing LLM-first skills.
skill-creator
Trigger: new skills, agent instructions, documenting AI usage patterns. Create LLM-first skills with valid frontmatter.