hrt-artifact-lint
Runs the deterministic structural lint over a tempa-spec change's artifacts (hashtag counts, checkbox format, delta headers, capability<->spec-file correspondence, Covers: target existence, design.md section presence, unverified External Dependencies rows, tasks.md group graph: Depends on, task coverage: Covers: per group in both directions, the threat chain: every design threat id named by a group's Covers: line, and that group carrying a [security] task, and proposal size and shape warnings) so a language model does not do this by hand. Called from hrt-adversarial-authoring and hrt-align-consistency-review. Judgement checks stay with the reviewers.
How do I install this agent skill?
npx skills add https://github.com/hash-id/openspec-schema --skill hrt-artifact-lintIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a structural linter for project documentation and is generally safe. It performs checks on markdown files using a bundled Node.js script. A low-severity risk exists regarding indirect prompt injection because the agent is instructed to automatically 'fix' errors based on linter output derived from untrusted repository content.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
hrt-artifact-lint
Run the bundled lint.cjs (sits next to this file, installed at .agents/skills/hrt-artifact-lint/lint.cjs, no dependencies) against the change directory - the folder with proposal.md, specs/, design.md, tasks.md:
node .agents/skills/hrt-artifact-lint/lint.cjs <change-dir>
In the proposal phase, when no later artifact exists yet, add --phase=proposal so the run checks proposal.md only (structure, size, shape) and does not report the missing specs, design, and tasks as errors.
Output is LEVEL path:line message, one per line, then a Size facts: line (capabilities, scenarios, task groups, proposal words; no verdict). Exit 1 if any ERROR, else 0.
- ERROR: a deterministic structural defect with exactly one correct fix. Fix it directly, no user prompt, record what changed.
- WARN: non-blocking. Fix if quick.
The caller does not re-run these checks by hand after the lint passes. The caller's judgement checks (is a scenario genuinely behaviour, is a requirement genuinely testable, is an N/A section genuinely non-applicable) are not covered here and still run.
If Node is missing or lint.cjs cannot be found, say so and fall back to checking these by hand. Do not skip them silently.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/hash-id/openspec-schema/hrt-artifact-lint">View hrt-artifact-lint on skillZs</a>