Skip to content

Skill files hard-wrap while comment-and-doc-style requires one paragraph per line #1814

Description

@ptr727

comment-and-doc-style "Markdown formatting" requires one logical paragraph per line, with no hard-wrap line-length limit. Every SKILL.md and references/*.md under .agents/skills/ is hard-wrapped at about 100 columns, so each new paragraph a change adds must choose between the rule and the file it sits in. Copilot raises it on new skill paragraphs, and the answer so far has been consistency with the surrounding file.

Done looks like: one of the two settles. Either the rule states that the skills tree is hard-wrapped, with the width, or the skills tree is reflowed to one paragraph per line in a single mechanical change, with build_dist.py regenerating the mirrors.

Activity

  1. added
    proseA defect in rule or procedure text
    on Sep 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    proseA defect in rule or procedure text

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions