Skip to content

Commit 859220b

Browse files
committed
chore: add root self-validation skill
1 parent 54e1c25 commit 859220b

2 files changed

Lines changed: 45 additions & 0 deletions

File tree

CHANGELOG.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,7 @@ Backward compatibility: previously-passing skills still pass. Some previously-fa
3333
- Renamed `config.KNOWN_FRONTMATTER_FIELDS` to `config.SPEC_FIELDS`.
3434
- New `template.detected` rule wired into `rules/__init__.py`.
3535
- Frontmatter rule implementation split into smaller modules while preserving `skillcheck.rules.frontmatter` imports.
36+
- Root `SKILL.md` restored so `skillcheck SKILL.md` self-validation works from the repository root.
3637
- New fixture set under `tests/fixtures/` covering ecosystem fields, user extensions, template detection, and demoted severities.
3738

3839
## [1.1.0] - 2026-04-28

SKILL.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
---
2+
name: skillcheck
3+
description: Validates SKILL.md files for spec-facing structure, sizing, references, cross-agent compatibility, and agent-authored critique or graph diagnostics.
4+
version: "1.2.0"
5+
author: brad
6+
---
7+
8+
Use this skill when validating a `SKILL.md` file or a directory of skill files with the `skillcheck` CLI.
9+
10+
## Validate
11+
12+
Run the default symbolic checks:
13+
14+
```bash
15+
skillcheck SKILL.md
16+
skillcheck skills/ --format json
17+
```
18+
19+
The report includes errors, warnings, and info diagnostics. Exit code 0 means no errors. Exit code 1 means at least one error, or warnings with `--warnings-as-errors`. Exit code 2 means input or argument error. Exit code 3 means symbolic validation passed but ingested agent critique found semantic errors.
20+
21+
## Agent workflows
22+
23+
For semantic self-critique, emit a prompt and ingest the returned JSON:
24+
25+
```bash
26+
skillcheck SKILL.md --emit-critique-prompt > prompt.txt
27+
skillcheck SKILL.md --ingest-critique response.json
28+
```
29+
30+
For capability graph work, use:
31+
32+
```bash
33+
skillcheck SKILL.md --analyze-graph
34+
skillcheck SKILL.md --emit-graph --format json
35+
```
36+
37+
## Configuration
38+
39+
`skillcheck.toml` can set CLI defaults and frontmatter extension fields:
40+
41+
```toml
42+
[frontmatter]
43+
extension_fields = ["my-org-tag", "internal-id"]
44+
```

0 commit comments

Comments
 (0)