Agent Skills › IgniteUI/igniteui-webcomponents › skill-authoring

skill-authoring

GitHub

规范 SKILL.md 的编写与更新，包括 frontmatter 校验、描述格式及 500 行长度限制，指导 Agent 创建或修改技能文件。

.agents/skills/skill-authoring/SKILL.md IgniteUI/igniteui-webcomponents

Trigger Scenarios

创建新的 skill 文件编辑现有 skill 的 frontmatter 或内容

Install

npx skills add IgniteUI/igniteui-webcomponents --skill skill-authoring -g -y

More Options

Non-standard path

npx skills add https://github.com/IgniteUI/igniteui-webcomponents/tree/master/.agents/skills/skill-authoring -g -y

Use without installing

npx skills use IgniteUI/igniteui-webcomponents@skill-authoring

指定 Agent (Claude Code)

npx skills add IgniteUI/igniteui-webcomponents --skill skill-authoring -a claude-code -g -y

安装 repo 全部 skill

npx skills add IgniteUI/igniteui-webcomponents --all -g -y

预览 repo 内 skill

npx skills add IgniteUI/igniteui-webcomponents --list

SKILL.md

Frontmatter

{
    "name": "skill-authoring",
    "license": "MIT",
    "description": "Provides rules for writing or updating a SKILL.md in this repository: frontmatter validation for license, name and description, the WHEN TO USE and WHEN NOT TO USE description format, and the 500-line body budget with progressive disclosure into reference files. WHEN TO USE: creating a new skill under .agents\/skills\/ or skills\/, or editing an existing skill's frontmatter, scope, or length. WHEN NOT TO USE: writing component code, styles, or tests (use create-new-component, add-component-property, or update-component-styles), reviewing a component pull request (use review-component-pr), or changing the coding rules themselves (edit .github\/CODING_GUIDELINES.md).",
    "user-invocable": true
}

Ignite UI for Web Components — Skill Authoring

Quick-reference for writing a SKILL.md that agents can discover and load reliably.

Location

Internal, contributor-facing skills: .agents/skills/<name>/SKILL.md
Public skills that ship with the package: skills/<name>/SKILL.md
The folder name must match the name field.

Frontmatter

Field	Rules
`license`	Required. Must specify the license under which the skill is released. Default is MIT.
`name`	Required. Max 64 characters. Lowercase letters, numbers, and hyphens only. No XML tags. No reserved words (`anthropic`, `claude`). Public skills use the `igniteui-wc-` prefix; internal skills use a plain kebab-case name.
`description`	Required. Non-empty. Max 1,024 characters. No XML tags.

Write the description in the third person: say what the skill covers, then add both markers:

WHEN TO USE: the tasks or triggers that should load the skill.
WHEN NOT TO USE: nearby tasks it does not cover, naming the skill to use instead.

Agents see only name and description until they load the skill, so the description decides whether it is ever used.

Token Budget

Keep the SKILL.md body under 500 lines.
If it grows past that, use progressive disclosure: keep the overview and core rules in SKILL.md and move detail into references/<topic>.md files.
Link each reference file directly from SKILL.md (one level deep) and say when to read it, so agents load it only when needed.

Checklist

Frontmatter passes the rules above.
The description includes WHEN TO USE: and WHEN NOT TO USE:.
The body is under 500 lines, and every reference file is linked from SKILL.md.
The skill is listed in the Skills table of its README: .agents/skills/README.md for internal skills, skills/README.md for public skills. Internal skills are also listed in the Workflow section of .agents/context/project.md.