llms.txt@packages/website/public git:20260905.3c9b754A

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

# Skillsmith - Shared skills, safe for production.
> For complete reference including full API docs, CLI commands, and FAQ, see: https://www.skillsmith.app/llms-full.txt
> Agent builders need the same vetted skills, not one-off files nobody's reviewed. Skillsmith shares them across your team, scans them for risk before they ship, and shows you which ones are actually being used. 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 every installed AI coding client's skill inventory for local 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)
- `apply_manifest_reconcile`: Repair a corrupted or ambiguous manifest entry (mark_local/relink/drop_entry/verify/revert)
- `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