# Skill Creator Linter

> Skill Creator Linter is an Agent Skill for agent building published in the opensquilla/opensquilla repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Internal tool (not user-invocable). Called by meta-skill-creator as a DAG step (kind: agent) to lint a candidate meta-skill SKILL.md against G1 (parse + reference check + xml_escape grep + structural lint) and G2 (scheduler dry-run with stub executors). Deterministic, sub-second, no LLM. Returns JSON diagnostics.

- Skill name: `skill-creator-linter`
- Category: [Agent Building](https://www.openparable.com/skill/agent-building/1)
- Source: https://github.com/opensquilla/opensquilla/blob/HEAD/src/opensquilla/skills/bundled/skill-creator-linter/SKILL.md
- Repository: opensquilla/opensquilla (6,081 GitHub stars when collected)

## SKILL.md

# Skill Creator Linter

Validates a candidate meta-skill SKILL.md before it gets registered.

## G1 rules

| Rule | Check |
|---|---|
| G1.1 | `parse_meta_plan` does not raise |
| G1.2 | Every `step.skill` for kind=agent/skill_exec exists in the main catalog |
| G1.3 | Template variables resolve at render time (covered by G1.1) |
| G1.4 | `on_failure` parser rules (covered by G1.1) |
| G1.5 | step `kind:` consistency (covered by G1.1) |
| G1.6 | Grep: every `{{ inputs.user_message | xml_escape` usage must have `xml_escape` (or `slugify`) as the first filter. Violations are reported as G1 errors (block linter). |

## G2 dry-run

Replace step executors with stubs yielding `_StepDone(text="<stub:id>")`. Run scheduler; pass if no exception and topology terminates.

## Usage

```
uv run python {baseDir}/scripts/lint.py --skill-md path/to/SKILL.md --gates G1,G2
uv run python {baseDir}/scripts/lint.py --skill-md-stdin --gates G1,G2 < SKILL.md
```

## Output

JSON to stdout: `{"G1": {"passed": bool, "diagnostics": [...]}, "G2": {...}}`.

## Fallback

Manually inspect SKILL.md and run `parse_meta_plan` in a Python REPL.

---

Source: https://www.openparable.com/skill/agent-building/skill-creator-linter (OpenParable). Cite the canonical URL above.
