ds-lint

Validate SKILL.md and agent markdown files against the Claude Code spec.

18|3|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/Dataslayer-AI/Marketing-skills --skill ds-lint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ds-lint
Source: https://github.com/Dataslayer-AI/Marketing-skills/tree/main/skills/ds-lint
Command: npx skills add https://github.com/Dataslayer-AI/Marketing-skills --skill ds-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml, and includes scripts (resource) components.

What problem does it solve?

Internal development tool that validates all SKILL.md and agent .md files against the Claude Code spec. Checks frontmatter completeness, field validity, allowed-tools presence, line count, hardcoded paths, and description quality. Use when the user says "lint skills", "validate skills", "check skill quality", "run the linter", "are my skills valid", or before shipping changes to the skills repo.

Core Features & Use Cases

  • Validates frontmatter completeness and field validity for all Skill and Agent Markdown files.
  • Enforces style, security checks (hardcoded paths, tool usage), and line-count limits to maintain quality.
  • Use case: integrate into CI to automatically block ships that fail the lint.

Quick Start

Run the linter against a repository root to validate all SKILL.md and agent.md files.

Frequently Asked Questions about ds-lint

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

FAQPage Schema
How do I validate Claude Code SKILL.md files against the spec?

To validate Claude Code SKILL.md files, run this linter against your repository root to check frontmatter completeness, field validity, and content quality across all skill and agent markdown files.

Can I check Claude Code skills for hardcoded paths and security issues?

Yes, you can check Claude Code skills for hardcoded paths and security issues by running the linter, which enforces security checks and validates allowed-tools presence to prevent unsafe configurations.

How do I integrate skill validation into CI to block bad ships?

You can integrate this linter into your CI pipeline to automatically block ships that fail the lint, ensuring all SKILL.md and agent markdown files meet formatting and quality standards before deployment.

What frontmatter fields are required for Claude Code agent markdown files?

Required frontmatter fields for Claude Code agent markdown files are validated by the linter for completeness and validity, including checks on model specifications, allowed-tools, and line counts.

Does the skill linter work on large repositories with many markdown files?

Yes, the linter applies to skill repos of any size, validating all SKILL.md and agent markdown files against the Claude Code spec to catch formatting and field validity issues during development.

Why does my Claude Code skill fail validation before shipping changes?

Your Claude Code skill fails validation when the linter detects frontmatter incompleteness, invalid fields, missing allowed-tools, line count violations, or hardcoded paths that violate the defined lint rules.