OpenParable
Skip to content
← Back to skills

Skill Creator Linter

Agent Building
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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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

RuleCheck
G1.1parse_meta_plan does not raise
G1.2Every step.skill for kind=agent/skill_exec exists in the main catalog
G1.3Template variables resolve at render time (covered by G1.1)
G1.4on_failure parser rules (covered by G1.1)
G1.5step kind: consistency (covered by G1.1)
G1.6Grep: 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.