llms.txt@packages/website/public git:20260818.93baf91A

Immutable. This exact content is served forever at /api/v1/blob/c58a095da4cd1215.

# Skillsmith - Lifecycle Management for Agent Skills
> For complete reference including full API docs, CLI commands, and FAQ, see: https://www.skillsmith.app/llms-full.txt
> Skills spread across teams faster than anyone can govern them. Skillsmith gives them a lifecycle: publish immutable versions to your team's registry, catch drift before it spreads, and deprecate what's gone stale. Skills are reusable prompts and workflows that extend AI assistant capabilities.

## Quick Start
Install Skillsmith MCP server to publish, install, and manage agent skills using natural language:

```json
// Add to ~/.claude/settings.json
{
  "mcpServers": {
    "skillsmith": {
      "command": "npx",
      "args": ["-y", "@skillsmith/mcp-server"]
    }
  }
}
```

Then ask your assistant: "Find skills for this project" or "Install the commit helper skill"

## CLI Alternative
```bash
npm install -g @skillsmith/cli
skillsmith search testing
skillsmith install jest-helper
skillsmith list
```

## Key Pages

- [Home](https://www.skillsmith.app/): Product overview and features
- [Quickstart](https://www.skillsmith.app/docs/quickstart): First-time setup guide with two paths (MCP client recommended, CLI alternative)
- [Skills Browser](https://www.skillsmith.app/skills): Browse and search available skills
- [Pricing](https://www.skillsmith.app/pricing): Four tiers - Community (free, 100 API calls), Individual ($9.99, 1k), Team ($25/user, 10k), Enterprise (custom pricing, unlimited)
- [CLI Reference](https://www.skillsmith.app/docs/cli): Complete CLI command documentation
- [MCP Server](https://www.skillsmith.app/docs/mcp-server): MCP integration configuration
- [API Reference](https://www.skillsmith.app/docs/api): REST API documentation
- [Private Registry](https://www.skillsmith.app/docs/private-registry): Enterprise-tier team registry — versioned, access-controlled, with a publish-and-approval workflow
- [Governance](https://www.skillsmith.app/docs/governance): Publish review, deprecation, audit trails, compliance reporting, and automatic quarantine

## What Are Skills?

Skills are YAML files installed to `~/.claude/skills/` that provide AI assistants with:
- Domain-specific knowledge and best practices
- Reusable workflows and templates
- Tool configurations and integrations
- Project-type-specific guidance

## Trust Tiers

| Tier | Description |
|------|-------------|
| verified | Official reviewed skills |
| community | Community-reviewed and tested |
| experimental | New or beta skills |

## Common Tasks

### Search for skills
Ask your assistant: "What skills would help with this React project?"
Or CLI: `skillsmith search react --category development`

### Install a skill
Ask your assistant: "Install the jest-helper skill"
Or CLI: `skillsmith install community/jest-helper`

### Get recommendations
Ask your assistant: "Recommend skills for my current project"
Or CLI: `skillsmith recommend`

### Compare skills
Ask your assistant: "Compare jest-helper and vitest-helper"
Or CLI: `skillsmith compare jest-helper vitest-helper`

## MCP Tools Available

When using Skillsmith MCP server:
- `search`: Search skills by query, category, trust tier
- `get_skill`: Get detailed skill information
- `install_skill`: Install a skill to ~/.claude/skills
- `uninstall_skill`: Remove an installed skill
- `recommend`: Get project-based skill recommendations
- `validate`: Validate a skill's structure
- `compare`: Compare multiple skills side-by-side
- `skill_suggest`: Proactively suggest skills based on your current project context (counts against monthly quota)
- `skill_outdated`: Check installed skills for staleness and dependency status
- `index_local`: Index skills from a local directory
- `skill_publish`: Prepare a local skill for publishing (reference check, optional GitHub repo creation)
- `skill_rescan`: Re-scan an installed skill's content for security/quality changes
- `skill_recover_source`: Recover the canonical GitHub source of locally-installed skills (read-only report + candidates)
- `inventory_push`: Push this machine's installed-skill inventory to your Skillsmith account for the web dashboard
- `skill_updates` (Individual+): Check the registry for newer skill versions
- `skill_diff` (Individual+): Section-level diff between two versions of a skill
- `skill_pack_audit` (Individual+): Audit all skills in a directory
- `skill_audit` (Team+): Check skills for known security advisories
- `skill_inventory_audit` (Team+): Audit local ~/.claude/ inventory for namespace collisions; returns rename + edit suggestions
- `apply_namespace_rename` (Team+): Apply a rename suggestion from an inventory audit (apply/custom/skip)
- `apply_recommended_edit` (Team+): Apply a recommended prose edit from an inventory audit
- `undo_apply` (Team+): Session-scoped undo of the most recent apply_namespace_rename/apply_recommended_edit changeset(s)
- `team_workspace` (Team+): Manage team workspaces (create, list, get, delete)
- `share_skill` (Team+): Add, remove, or list skills in a team workspace
- `publish_private` (Team+): Mark a skill private on this device, hiding it from your own search results
- `team_analytics_dashboard` (Team+): Per-user tool usage counts, top tools, and daily trend
- `team_usage_report` (Team+): Weekly/monthly usage summary with period comparison
- `audit_export` (Enterprise): Export audit log events for a time range
- `audit_query` (Enterprise): Query audit logs with filters
- `siem_export` (Enterprise): Export audit events for SIEM ingestion
- `analytics_dashboard` (Enterprise): Recommendation accuracy, adoption curves, and team aggregation
- `usage_report` (Enterprise): Comprehensive usage report with all metrics
- `configure_sso` (Enterprise): Configure SSO/SAML integration (set, test, remove)
- `sso_settings` (Enterprise): View current SSO/SAML configuration
- `private_registry_publish` (Enterprise): Publish a skill version to your team's private registry as a pending submission
- `private_registry_manage` (Enterprise): List, get, install, deprecate, and review skills in your team's private registry — including approving/rejecting pending submissions
- `rbac_manage` (Enterprise): Manage RBAC roles (create, list, get, delete)
- `rbac_assign_role` (Enterprise): Assign or revoke roles for users
- `rbac_create_policy` (Enterprise): Create and manage RBAC access policies
- `compliance_report` (Enterprise): Generate SOC2, CycloneDX SBOM, or JSON compliance reports

## Packages

| Package | npm | Description |
|---------|-----|-------------|
| @skillsmith/mcp-server | `npx -y @skillsmith/mcp-server` | MCP server for agent skills |
| @skillsmith/cli | `npm i -g @skillsmith/cli` | Command-line interface |
| @skillsmith/core | - | Core library (internal) |

## License

Elastic License 2.0 (ELv2)
- Self-hosting permitted
- Modification for own use permitted
- Cannot offer as managed service to third parties

## Contact

- Website: https://www.skillsmith.app
- GitHub: https://github.com/smith-horn/skillsmith
- Contact: https://www.skillsmith.app/contact

## Frequently Asked Questions

Q: What are agent skills?
A: Skills are reusable prompts and workflows installed to ~/.claude/skills/ that give AI assistants specialized capabilities like testing, deployment, code review, and documentation generation.

Q: Is Skillsmith free?
A: Yes. The Community tier is free forever with 100 API calls per month. Paid plans start at $9.99/month.

Q: What AI tools does it work with?
A: Any MCP-compatible client including Claude Code, Claude Desktop, Cursor, Windsurf, and other Model Context Protocol tools.

Q: How do I install a skill?
A: Add the Skillsmith MCP server to your settings.json, then ask your assistant to install it. One step.

## Optional

- Logo: https://www.skillsmith.app/logo-icon.svg
- Changelog: https://www.skillsmith.app/changelog
- Terms: https://www.skillsmith.app/terms
- Privacy: https://www.skillsmith.app/privacy