Skip to content

Restructure SKILL.md: trigger logic only in description, body is HOW-only #9

@UditAkhourii

Description

@UditAkhourii

The skill body currently has a "When to trigger" section. But that section never gets loaded into context unless the skill is already triggered — at which point the trigger decision has already been made by the description in the YAML frontmatter. The body's trigger section is dead weight.

Restructure:

  • Description (YAML frontmatter): trigger logic + self-judge criteria. Already correctly placed.
  • Body: HOW to run the loop (phases, frames, output shape, anti-patterns). Strip the redundant "When to trigger" section.

Quick, real, low-effort fix.


Raised by u/UglyChihuahua.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationgood first issueGood for newcomersskillSKILL.md / Claude Code skill changes

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions