SuperAPI AI Directory

igniteui-angular-skill-authoring

Writing & research

View repository

Updated 10-15 22:17

About this skill

Ignite UI for Angular — 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). Use the igniteui-angular- prefix.
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.

MCP Servers in Public Skills

Which MCP server a public skill requires depends on what it covers:

Skill covers Required server Verification call
Component or grid usage (selectors, imports, inputs, outputs, methods) igniteui-cli list_components with framework: "angular"
Theming (palettes, themes, typography, elevations, component design tokens) igniteui-theming detect_platform

A skill that covers both, such as building views from a design, requires both servers. For each required server, the skill must:

  • Verify the server before any other step, using the call in the table.
  • If the tool is missing, tell the agent to configure it itself with npx -y igniteui-cli ai-config (or ig ai-config), ask the user to reload, and stop. Continuing without the server happens only at the user's explicit request, with unverified details flagged.
  • Never describe the server as optional or add "when available" fallbacks.

Follow the existing wording in igniteui-angular-components and igniteui-angular-theming.

Checklist

  1. Frontmatter passes the rules above.
  2. The description includes WHEN TO USE: and WHEN NOT TO USE:.
  3. The body is under 500 lines, and every reference file is linked from SKILL.md.
  4. Public skills include the required MCP server check: igniteui-cli for component usage, igniteui-theming for theming.
  5. The skill is listed in the Skills table in AGENTS.md. Internal skills are also listed in .agents/README.md and .github/copilot-instructions.md.

Related Skills