skill-structure git:20260807.5db9b3eA

Immutable. This exact content is served forever at /api/v1/blob/cab5907aa5132762.

---
description: Skill folder layout, SKILL.md frontmatter, naming conventions, and build-time flavors
globs: ["skills/**/SKILL.md", "skills/**/references/**/*.md", "skills/**/assets/**/*", "skill-flavors/**/*", "scripts/compose-skill-flavor.mjs", "scripts/npm-package-lifecycle.mjs", "scripts/select-skill-package.mjs", ".github/workflows/publish.yml", ".github/workflows/publish-studioweb.yml", ".github/workflows/*skill-flavor*.yml"]
---

Every skill under `skills/uipath-<kebab-case>/` must have a `SKILL.md` with valid YAML frontmatter: `name` (matching folder name exactly) and `description` (under 1024 characters — repo cap; Claude Code's hard truncation for `description` + `when_to_use` is 1,536 chars).

The `description` must front-load skill identity and unique file/domain signals (e.g. `.cs`, `.xaml`, `.flow`, `servo`) within the first ~100 characters. Use compact `→` redirects for commonly confused sibling skills (e.g. `For XAML→uipath-rpa`). Start with `[PREVIEW]` for unstable skills. Do NOT use verbose `TRIGGER when:` / `DO NOT TRIGGER when:` clauses or nest fields under `metadata:` — both cause Claude Code to drop the field.

SKILL.md body order: Title → When to Use → Critical Rules (numbered) → Workflow/Quick Start → Reference Navigation → Anti-patterns. Reference files use kebab-case; guides end with `-guide.md`; templates end with `-template.md` or `-template.<ext>`. Skills must be self-contained — no cross-skill references.

Full reference: `.claude/rules/skill-structure.md`.

Before changing flavor markers, sparse overrides, generic discovery,
package construction, publishing, or flavor CI, read
`.claude/skills/manage-skill-flavors/SKILL.md` completely and follow its
reference-routing instructions.