Skill Creator Linter
Agent Buildingskill-creator-linterSkill 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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/opensquilla/opensquilla/blob/HEAD/src/opensquilla/skills/bundled/skill-creator-linter/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/skill-creator-linter, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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 |
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.