kf-g-skill-authoring-body-structure-rules

skill Basic Rules for Body Structure

This skill defines the basic rules for the body structure and instruction writing of SKILL.md. For naming and placement, refer to kf-g-skill-naming-creation-organization-rules; for the overall creation procedure, refer to skill-creator .

Basic Rules (Overview)

1. Mandatory procedures in affirmative form: Write instructions for start conditions, procedures, and output conditions in the form "always do this"
2. description is the application gate: frontmatter description controls whether it applies
3. SKILL.md is a table of contents: Focus on how to read through and the reference table of contents, and separate details into references

Reference Files

• references/overview.md — When starting: When checking the overall picture of the basic rules, the scope of application, and the division of roles with other skills
• references/positive-instruction-style.md — When starting: When writing or revising instructions into mandatory procedures in affirmative form
• references/description-as-gate.md — When starting: When preparing the description as the application gate
• references/when-to-use-section.md — When starting: When deciding whether the body "When to Use" section is necessary and where to place it
• references/toc-and-references.md — When starting: When turning SKILL.md into a table of contents and separating details into references

Minimal Application Procedure

1. references/overview.md to check the basic rules and scope of application
2. Open one or more of the above reference files according to what you are starting
3. Organize SKILL.md and references with a structure that satisfies each basic rule
4. Judge completion using the "Final Check" below

Final Check

1. The procedures in the body are in affirmative form for start conditions, execution procedures, and output conditions
2. The application conditions are written in frontmatter description , and the body is allocated to execution procedures
3. If there is a "When to Use" section, it is limited to supplementary information for the description (details, boundaries, examples)
4. SKILL.md focuses on the table of contents and how to read through, and details can be reached via Markdown links
5. Only principle details are placed in references, and application conditions are consolidated into the description