addyosmani / addyosmani/agent-skills

Add automated SKILL.md linting and format standardization

Open
#137 1 comment 1 reaction 0 assignees View on GitHub
Dominant language
JavaScript
Stars
93.8k
Forks
10k
Avg merge
3d 15h
Merged PRs (30d)
23

Description

While SKILL.md files are generally well-structured, there are minor formatting inconsistencies across skills:

- Heading levels vary (some use \`##\`, others use \`###\` for similar sections)
- List formatting varies (some use \`-\`, others use \`*\`)
- Code block indentation is inconsistent
- Frontmatter field ordering varies

## Proposal

1. Add \`markdownlint\` configuration for automated format checking
2. Standardize heading levels across all SKILL.md files
3. Ensure consistent use of \`-\` for bullet lists
4. Document formatting conventions in \`CONTRIBUTING.md\`

This improves polish and helps AI agents parse files consistently.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.