---
name: "skill-manifest-linter-validator"
description: "Validate and lint agent skill packages against the official SKILL.md specification."
metadata:
  author: "Agent Skills Standard"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "validate skill.md file"
  - "lint agent skill manifest"
  - "check skill permissions schema"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# SKILL.md Spec Linter & Frontmatter Validator

Lints skill directories against standard schemas: YAML frontmatter validation, trigger natural language phrasing, permission declarations, bundled script checks, and markdown structure.

## When to Invoke
Invoke this skill whenever you need to:
- validate skill.md file
- lint agent skill manifest
- check skill permissions schema

## Execution SOP & Rules
1. Verify valid YAML frontmatter demarcated by triple dashes (---).
2. Ensure required fields are populated: name, description, triggers, and permissions.
3. Verify that triggers contain at least 2 distinct natural language invocation phrases.
4. Validate that permission booleans (fs_read, fs_write, shell_exec) match actual script behavior.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.