# Sample Skill

> Use when validating the SkillForge validator itself - exercises every supported frontmatter feature: boolean user-invocable, an allowed-tools block list, and nested metadata with an inline list.

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

---


# Sample Skill

A fixture skill used by test_validate_skill.py. It uses every frontmatter
feature the vendored YAML parser must support, and satisfies every
structural check in validate_skill.py, so the full validator must report
zero errors for it.

## Process

1. Run the validator against this directory.
2. Assert that the error list is empty.
3. Assert that typed values survived parsing (booleans stay booleans).

| Step | Check | Expected |
|------|-------|----------|
| 1 | frontmatter parse | no error |
| 2 | user-invocable | bool True |
| 3 | allowed-tools | list of 3 tools |

## Verification

- [ ] validate_skill.py reports zero errors
- [ ] quick_validate.py reports the skill as valid
- [ ] user-invocable parsed as a boolean

## Anti-Patterns

- Do not pin a dated model ID in frontmatter.
- Do not duplicate reference content in collapsible details blocks.

## Extension Points

- Add hooks frontmatter once the vendored parser grows hook fixtures.
- Add a scripts/ directory to exercise script lint checks.