Skip to content
skill-linter logo

Skill Linter

skill-linter

Validate skills against agentskills.io specification. Use when adding new skills to the marketplace, reviewing skill PRs, checking skill compliance, or running quality gates on skills. Validates frontmatter fields (name, description, license, compatibility, metadata, allowed-tools), directory nam...

SKILL.md

Full skill instructions

Skill Linter

When to Use

  • Adding new skills to the marketplace
  • Reviewing skill PRs
  • Running quality gates before merge
  • Checking existing skills for compliance

Validation Rules

Required Frontmatter

FieldConstraints
name1-64 chars, lowercase alphanumeric + hyphens, no leading/​trailing/​consecutive hyphens, must match parent directory name
description1-1024 chars, non-empty, should include keywords for discoverability

Optional Frontmatter

FieldConstraints
licenseShort license name or file reference
compatibility1-500 chars, environment requirements
metadataKey-value pairs (string values only)
allowed-toolsSpace-delimited tool list

Structure Requirements

RuleRequirement
Directory nameMust match name field exactly
SKILL.mdRequired, must exist
Line limitMax 500 lines in SKILL.md
SubdirectoriesOnly scripts/, references/, assets/ allowed

Name Pattern

^[a-z][a-z0-9]*(-[a-z0-9]+)*$

Valid: my-skill, skill1, api-v2-handler Invalid: -skill, skill-, my--skill, MySkill, my_skill

Usage

Validate Single Skill

./​scripts/​validate-skill.sh path/​to/​skill-name

Validate All Marketplace Skills

for skill in plugins/​*/​skills/​*/; do
  ./​scripts/​validate-skill.sh "$skill"
done

CI Integration

Add to pre-commit hook or CI pipeline:

- name: Lint Skills
  run: |
    for skill in plugins/​*/​skills/​*/; do
      .claude/​skills/​skill-linter/​scripts/​validate-skill.sh "$skill" || exit 1
    done

Validation Script

The linter script at scripts/​validate-skill.sh performs these checks:

  1. Directory exists with SKILL.md file
  2. Frontmatter present with YAML delimiters
  3. Name field valid - pattern, length, matches directory
  4. Description field valid - present, length constraints
  5. Optional fields valid - if present, match constraints
  6. Line count - under 500 lines
  7. Subdirectory names - only allowed directories

Error Codes

CodeMeaning
0All validations passed
1Missing SKILL.md
2Invalid frontmatter
3Name validation failed
4Description validation failed
5Optional field validation failed
6Line limit exceeded
7Invalid subdirectory

Example Output

Validating: plugins/​majestic-tools/​skills/​brainstorming

[PASS] SKILL.md exists
[PASS] Frontmatter present
[PASS] Name 'brainstorming' valid (12 chars)
[PASS] Name matches directory
[PASS] Description valid (156 chars)
[PASS] Line count: 87/​500
[PASS] Subdirectories valid

Result: ALL CHECKS PASSED

Spec Reference

Based on agentskills.io/​specification:

  • Progressive disclosure - Metadata ~100 tokens at startup, full content <5000 tokens when activated
  • Reference files - Keep one level deep from SKILL.md
  • Token budget - Main SKILL.md recommended under 500 lines

More Finance & Trading skills

ponytail-debt logo
Finance & Trading

ponytail-debt

Harvest every `ponytail:` comment in the codebase into a debt ledger, so the deliberate shortcuts and deferrals ponytail leaves behind get tracked instead of rotting into "later means never". One-shot report, changes nothing.

155.5K 27.9K
View
stripe-integration logo
Finance & Trading

stripe-integration

Stripe payment processing with checkout sessions, subscriptions, webhooks, and customer management.

40.2K 12.9K
View

Build comprehensive 3-5 year financial models with revenue projections, cost structures, cash flow analysis, and scenario planning for early-stage startups. Use this skill when creating financial projections, calculating burn rate or runway, modeling fundraising scenarios, or preparing investor-r...

40.2K 12K
View
stock-analysis logo
Finance & Trading

stock-analysis

Stock and cryptocurrency analysis with portfolio management and multi-dimensional scoring.

46 11.9K
View
coinglass logo
Finance & Trading

coinglass

Real-time crypto derivatives positioning, whale tracking, liquidations, and institutional ETF flows across 37 specialized tools.

27 11.5K
View

Master dbt (data build tool) for analytics engineering with model organization, testing, documentation, and incremental strategies. Use when building data transformations, creating data models, or implementing analytics engineering best practices.

40.2K 10.5K
View

Finance AI tools

C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Finalle.ai logo
Finance

Finalle.ai

Stay Ahead with Finalle.ai: The Ultimate Financial News and Tools Platform

Free
View

AI-powered Pine Script code generator for TradingView

Paid
View
TradeUI logo
Finance

TradeUI

Empower your investment strategies with AI signals, option flow data, and advanced chart patterns.

Paid
View
D
Finance

Danelfin

Danelfin review covering its AI stock and ETF scores, rankings, portfolio tools, current pricing, strengths, risks, and alternatives for investors.

Freemium
View
E
Finance

Ellisense

A software for comprehensive market sentiment analysis.

Paid
View

'Stock Correlations' App by Freshly.ai: Reveal Stock Patterns and Trends

Free
View