sutras 0.1.1

Devtool for creating, testing, and distributing Anthropic Agent Skills with lifecycle management and Skill ABI

Sutras

Devtool for Anthropic Agent Skills with lifecycle management.

Sutras is a CLI tool and library for creating, validating, and managing Anthropic Agent Skills. It provides scaffolding, validation, and a standardized Skill ABI for better skill organization and quality.

Key Features

• Scaffold: Generate skills with proper structure and best-practice templates
• Validate: Check skill format, metadata, and quality standards
• Discover: List and inspect available skills in your workspace
• Manage: Organize skills with versioning and metadata

Why Sutras?

Creating Anthropic Skills manually requires:

• Writing SKILL.md files with correct YAML frontmatter
• Managing metadata and descriptions
• Ensuring consistent structure
• Validating format and quality

Sutras automates this with simple CLI commands.

Installation

pip install sutras

Or with uv:

uv pip install sutras

Quick Start

Create a New Skill

sutras new my-skill --description "What this skill does and when to use it"

This creates:

.claude/skills/my-skill/
├── SKILL.md           # Skill definition with YAML frontmatter
├── sutras.yaml        # Metadata (version, author, tests, etc.)
└── examples.md        # Usage examples

List Skills

sutras list

View Skill Details

sutras info my-skill

Validate a Skill

sutras validate my-skill

# Strict mode (warnings become errors)
sutras validate my-skill --strict

CLI Reference

# Create a new skill
sutras new <name> [--description TEXT] [--author TEXT] [--global]

# List skills
sutras list [--local/--no-local] [--global/--no-global]

# Show skill details
sutras info <name>

# Validate skill
sutras validate <name> [--strict]

Coming Soon

• sutras test - Run skill tests
• sutras eval - Evaluate with metrics
• sutras build - Package for distribution
• sutras publish - Share to registry

Skill Structure

Every skill contains:

SKILL.md (required)

Standard Anthropic Skills format with YAML frontmatter:

---
name: my-skill
description: What it does and when Claude should use it
allowed-tools: Read, Write  # Optional
---

# My Skill

Instructions for Claude on how to use this skill...

sutras.yaml (recommended)

Extended metadata for lifecycle management:

version: "1.0.0"
author: "Your Name"
license: "MIT"

capabilities:
  tools: [Read, Write]

distribution:
  tags: ["automation", "pdf"]
  category: "document-processing"

Supporting Files (optional)

• examples.md - Usage examples
• Additional resources as needed

Skill Locations

Skills are stored in:

• Project: .claude/skills/ (shared via git)
• Global: ~/.claude/skills/ (personal only)

Use --global flag with sutras new to create global skills.

Library Usage

from sutras import SkillLoader

loader = SkillLoader()
skills = loader.discover()           # Find all skills
skill = loader.load("my-skill")      # Load specific skill

print(skill.name)
print(skill.description)
print(skill.version)

Examples

See examples/skills/ for sample skills demonstrating best practices.

Contributing

Contributions welcome! See CONTRIBUTING.md for:

• Development setup
• Code style guidelines
• Testing requirements
• PR process

License

MIT License - see LICENSE