skillcheck
Validates skill quality — preprocessing safety, frontmatter, line counts, references. Use when checking skills, validating SKILL.md, or when skillcheck, lint skill, or validate skill are mentioned.
来源信息
- 仓库
- outfitter-dev/outfitter
- 最近来源活动
- 2026年2月25日 16:13
- 检测到的 SKILL.md 语言
- 英语
- 星标
- 6
- 分支
- 1
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
文件资源管理器
2 个文件正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- skillcheck
- description
- Validates skill quality — preprocessing safety, frontmatter, line counts, references. Use when checking skills, validating SKILL.md, or when skillcheck, lint skill, or validate skill are mentioned.
- context
- fork
- metadata
- {"version":"1.0.1","author":"outfitter","preprocess":true,"related-skills":["skillcraft","claude-craft"]}
- allowed-tools
- Read, Glob, Grep, Bash, Task
- argument-hint
- [path]
# Skills Check
Validate skill quality across one or more skill directories.
## Preprocessing Lint
Scan SKILL.md files for `` <bang>`command` `` patterns that trigger Claude Code's preprocessor unintentionally:
!`bun ${CLAUDE_PLUGIN_ROOT}/skills/skillcheck/scripts/lint-preprocessing.ts ${ARGUMENTS:-${CLAUDE_PLUGIN_ROOT}}`
## Interpreting Results
The linter reports:
- File path and line number of each finding
- The matched pattern and surrounding context
- Summary counts (clean, skipped, issues)
### Fixing Issues
| Finding | Fix |
| ----------------------------------------------- | ---------------------------------------------- |
| Unintentional `` <bang>`command` `` in SKILL.md | Replace `!` with `<bang>` |
| Intentional preprocessing | Add `metadata.preprocess: true` to frontmatter |
### The `<bang>` Convention
SKILL.md files are preprocessed by Claude Code — any `` <bang>`command` `` syntax executes when the skill loads. To safely document or reference the syntax:
- In SKILL.md: use `<bang>` as a stand-in for `!`
- In reference files (references/, EXAMPLES.md): literal `!` is fine and encouraged
- In command files (commands/\*.md): literal `!` is required (that's the feature)
Skills that intentionally preprocess (running scripts at load time) should declare it:
```yaml
metadata:
preprocess: true
```
## Additional Checks
Beyond preprocessing, verify skill quality with existing tools:
```bash
# Frontmatter validation
bun ${CLAUDE_PLUGIN_ROOT}/scripts/validate-skill-frontmatter.ts <path-to-SKILL.md>
# Full plugin validation
bun ${CLAUDE_PLUGIN_ROOT}/scripts/validate-plugin.ts <plugin-directory>
```
## Deep Validation
After reviewing linter results, spawn the `quartermaster` agent to run deeper validation — frontmatter schema, naming conventions, description quality, line counts, and reference integrity. Pass it the same path argument.
## Quality Checklist
- [ ] No unintentional `` <bang>`command` `` in SKILL.md (this linter)
- [ ] Valid frontmatter (name, description, required fields)
- [ ] SKILL.md under 500 lines
- [ ] All referenced files exist
- [ ] Description has WHAT + WHEN + trigger keywords
在 GitHub 查看