The TypeScript toolkit for
Agent Skills

Get started

# Install globally
npm install -g @skillscraft/cli

# Or use npx
npx @skillscraft/cli init my-skill

# Install the core library
npm install @skillscraft/core

# TypeScript types
npm install @skillscraft/spec

Quick start

# Create a new skill
skill init my-skill

# Validate against the Agent Skills specification
skill validate my-skill

# Lint for best practices (context budget, description quality, etc.)
skill lint my-skill --fix

Programmatic API

import { parseSkill, validateSkill, lintSkill } from "@skillscraft/core";

// Parse a SKILL.md file
const skill = await parseSkill("./my-skill/SKILL.md");

// Validate against spec
const result = validateSkill(skill);
if (!result.valid) console.log(result.errors);

// Lint for best practices
const lint = lintSkill(skill);
lint.diagnostics.forEach(d =>
  console.log(`[${d.severity}] ${d.rule}: ${d.message}`)
);

Lint rules

Best-practice checks that go beyond spec compliance.

Resources