.claude/skills/architecture-decision/SKILL.md has no top-level H1 for the skill itself. After the YAML frontmatter the file goes directly into When this skill is invoked: followed by ## 0. Parse Arguments. The first # ... heading in the file is at line ~234: # ADR-[NNNN]: [Title] — but that is the placeholder title inside the ADR template the skill writes to disk, not a heading for the skill.
The skill's frontmatter name is architecture-decision, but a reader scanning the rendered file sees only a literal raw template placeholder as the document title.
Suggested fix
Insert a top-level H1 right after the frontmatter:
# architecture-decision: write an Architecture Decision Record (ADR)
The # ADR-[NNNN]: [Title] placeholder later in the file (used by the ADR template) is unchanged.
A pull request implementing this is at #84.
.claude/skills/architecture-decision/SKILL.mdhas no top-level H1 for the skill itself. After the YAML frontmatter the file goes directly intoWhen this skill is invoked:followed by## 0. Parse Arguments. The first# ...heading in the file is at line ~234:# ADR-[NNNN]: [Title]— but that is the placeholder title inside the ADR template the skill writes to disk, not a heading for the skill.The skill's frontmatter
nameisarchitecture-decision, but a reader scanning the rendered file sees only a literal raw template placeholder as the document title.Suggested fix
Insert a top-level H1 right after the frontmatter:
The
# ADR-[NNNN]: [Title]placeholder later in the file (used by the ADR template) is unchanged.A pull request implementing this is at #84.