linting-instructions

Apply Opus 4.6 and Sonnet 4.6 model-card lint rules to agent instructions.

35|5|Updated Jul 5, 2025
One-click install
npx skills add https://github.com/alexei-led/cc-thingz --skill linting-instructions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linting-instructions
Source: https://github.com/alexei-led/cc-thingz/tree/main/plugins/dev-tools/skills-codex/linting-instructions
Command: npx skills add https://github.com/alexei-led/cc-thingz --skill linting-instructions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a structured, automated approach to auditing and linting plugin instructions against Claude Opus 4.6 and Sonnet 4.6 model cards, helping authors ensure safety, consistency, and compliance.

Core Features & Use Cases

  • Regex pre-pass linting: Quickly identify structural issues in prompts before deeper review.
  • Model-based semantic review: Evaluates intent, safety, and alignment with policy rules through a guided agent workflow.
  • Batch and report outputs: Produces structured PASS/WARN/FAIL results with actionable fixes for multiple files.
  • Plug-and-play for Codex Gemini AGENTS.md: Integrates into existing plugin instruction workflows to improve quality during authoring or auditing.

Quick Start

Lint your plugin instructions with the included tooling to surface rule violations and guidance for improvements.

Frequently Asked Questions about linting-instructions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I lint plugin prompts for safety and quality issues?

Lint plugin prompts for safety and quality by applying Opus 4.6 and Sonnet 4.6 model-card rules through a regex pre-pass and model-based semantic review, generating structured PASS/WARN/FAIL verdicts with actionable fixes.

What is prompt linting against model cards?

Prompt linting against model cards is the automated process of auditing plugin instructions for safety and policy compliance using Opus 4.6 and Sonnet 4.6 model-card rules, combining regex checks with semantic review to produce actionable verdicts.

Can I use this to audit AGENTS.md instructions for Codex CLI and Gemini CLI?

Yes, you can audit AGENTS.md-compatible instructions for Codex CLI and Gemini CLI. The linting process evaluates agent and skill instructions against model-card rules during authoring or reviewing tasks.

How do I run a batch lint on multiple plugin instruction files?

Batch lint multiple plugin instruction files by running the included scripts tooling, which applies a regex pre-pass and model-based review to produce structured PASS, WARN, or FAIL reports with specific actionable fixes for each file.

What is the difference between regex pre-pass and model-based semantic review?

Regex pre-pass quickly identifies structural issues in prompts before deeper review, while model-based semantic review evaluates intent, safety, and alignment with policy rules through a guided agent workflow.

When should I not rely on automated prompt linting for policy compliance?

Automated prompt linting provides structured PASS/WARN/FAIL verdicts but may not catch nuanced contextual edge cases. Manual review remains necessary when addressing complex safety policies or ambiguous agent instruction logic not covered by model-card rules.