# Skill Quality Standards

> When creating or validating skills. Reference for SKILL-CREATOR and SKILL-VALIDATOR.

- Skill: `majiayu000/skill-quality-standards` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/skill-quality-standards`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/skill-quality-standards/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/skill-quality-standards

---


## When to Use
When creating or validating skills. Reference for SKILL-CREATOR and SKILL-VALIDATOR.

## Patterns

### Size Limits
```
Target:  400-1000 tokens (optimal)
Maximum: 1500 tokens (hard limit)
Per task: max 3 skills loaded

Estimation:
  1 word ≈ 1.3 tokens
  1 code line ≈ 10 tokens
  Full skill ≈ 100-150 lines
```

### Confidence Levels
```
HIGH:
  - 2+ authoritative sources (Tier 1-2)
  - Patterns tested in production
  - Official docs cited

MEDIUM:
  - 1 authoritative source
  - Community-validated patterns
  - Reputable tech blog

LOW:
  - Blog posts only
  - Experimental/unverified
  - No official source
```

### Required Sections
```markdown
---
[YAML frontmatter with metadata]
sources:
  - [URL or internal path]
---

## When to Use
[1-2 sentences - clear trigger]

## Patterns
[2-3 patterns with code examples]
[Each with source citation]

## Anti-Patterns
[What NOT to do + why]

## Verification Checklist
[Actionable checks]
```

### Skill Types
```
Generic:    .claude/skills/generic/
            Tech-agnostic, reusable anywhere

Domain:     .claude/skills/domain/
            Industry-specific (fintech, healthcare)

Project:    .claude/skills/project/
            Repo-specific patterns
```

## Anti-Patterns
- Skills over 1500 tokens (split them)
- Patterns without source links in frontmatter
- Vague "When to Use" triggers
- Theory without code examples
- Missing anti-patterns section

## Verification Checklist
- [ ] Under 1500 tokens
- [ ] Every pattern has source in frontmatter
- [ ] "When to Use" is specific
- [ ] 2+ patterns with code
- [ ] Anti-patterns included
- [ ] Checklist is actionable