### Example: Install a Selected Skill

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/assets/skillsmith-skill/SKILL.md

After searching and presenting results, this example shows how to install a user-selected skill using mcp__skillsmith__install_skill.

```json
{ "id": "community/react-testing-library-helper" }
```

--------------------------------

### Clone and Set Up Skillsmith Development Environment

Source: https://github.com/smith-horn/skillsmith/blob/main/CONTRIBUTING.md

Follow these steps to clone the repository, start the Docker environment, install dependencies, and run tests to verify your setup.

```bash
# 1. Clone the repository (or fork first for contributions)
git clone https://github.com/smith-horn/skillsmith.git
cd skillsmith

# 2. Start Docker container
docker compose --profile dev up -d

# 3. Install dependencies
docker exec skillsmith-dev-1 npm install

# 4. Run tests to verify setup
docker exec skillsmith-dev-1 npm test
```

--------------------------------

### Example: Get Skill Recommendations

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/assets/skillsmith-skill/SKILL.md

This example shows how to get skill recommendations based on the current project context using mcp__skillsmith__skill_recommend.

```json
{ "context": "Node.js TypeScript API with Express" }
```

--------------------------------

### Install npm dependencies and start development server

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/README.md

After generating an MCP server project, navigate to the project directory, install dependencies using npm, and start the development server with `npm run dev`.

```bash
cd my-mcp-server
npm install
npm run dev  # Start in development mode
```

--------------------------------

### Quick Start with Skillsmith Core

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/core/README.md

Initialize the database, create repository and search service instances, and perform an initial search for skills. Requires database connection and cache setup.

```typescript
import {
  openDatabase,
  SkillRepository,
  SearchService,
  TieredCache,
} from '@skillsmith/core'

// Open database
const db = openDatabase('~/.skillsmith/skills.db')

// Create repository and search service
const skillRepo = new SkillRepository(db)
const cache = new TieredCache()
const searchService = new SearchService(skillRepo, cache)

// Search for skills
const results = await searchService.search({
  query: 'testing',
  limit: 10,
})
```

--------------------------------

### Development Commands

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/README.md

Essential commands for installing dependencies, starting the development server with Astro, and building the project for production.

```bash
# Install dependencies
npm install
```

```bash
# Start development server (Astro)
npm run dev
```

```bash
# Build for production
npm run build
```

--------------------------------

### Clone Repository and Start Development Container

Source: https://github.com/smith-horn/skillsmith/blob/main/README.md

Initial setup steps to clone the Skillsmith repository and launch the development environment using Docker Compose.

```bash
# 1. Clone the repository
git clone https://github.com/smith-horn/skillsmith.git
cd skillsmith

# 2. Start the development container
docker compose --profile dev up -d

# 3. Install dependencies (first time only)
docker exec skillsmith-dev-1 npm install

# 4. Build and test
docker exec skillsmith-dev-1 npm run build
docker exec skillsmith-dev-1 npm test
```

--------------------------------

### Interactive Search and Install

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/README.md

Initiates an interactive mode for searching and installing skills. This allows for a guided experience.

```bash
skillsmith search --interactive
```

--------------------------------

### Skillsmith CLI Usage Examples (Development)

Source: https://github.com/smith-horn/skillsmith/blob/main/README.md

Execute various Skillsmith CLI commands after building the project. Examples include searching with filters, getting skill details, and installing skills.

```bash
# From the repository, after building
node packages/cli/dist/index.js search "testing" --tier verified --min-score 80
node packages/cli/dist/index.js get community/jest-helper
node packages/cli/dist/index.js install community/jest-helper
```

--------------------------------

### Install a Skill

Source: https://context7.com/smith-horn/skillsmith/llms.txt

Use `installSkill` to install a skill from the registry or a GitHub URL. Options include forcing reinstallation, skipping security scans or optimization, defining conflict resolution actions, and confirming installation for experimental tiers.

```typescript
const result = await installSkill({ skillId: 'anthropic/commit' }, context);
```

```typescript
const result = await installSkill({
  skillId: 'https://github.com/user/my-skill',
  force: false,              // Force reinstall if exists
  skipScan: false,           // Skip security scan (not recommended)
  skipOptimize: false,       // Skip Skillsmith optimization
  conflictAction: 'merge',   // overwrite, merge, or cancel
  confirmed: false           // Required for experimental/unknown tiers
}, context);
```

```json
{
  success: true,
  skillId: 'anthropic/commit',
  installPath: '/Users/me/.claude/skills/commit',
  trustTier: 'verified',
  securityReport: {
    passed: true,
    riskScore: 5,
    findings: [],
    scannedAt: '2024-01-15T10:30:00Z'
  },
  optimization: {
    optimized: true,
    tokenReductionPercent: 15,
    originalLines: 150,
    optimizedLines: 128
  },
  tips: ['Use /commit to generate semantic commit messages'],
  depIntel: {
    mcpServers: ['@anthropic/mcp-sdk'],
    npmPackages: []
  }
}
```

--------------------------------

### Install Skill

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/mcp-server/README.md

Install a skill into your local environment.

```APIDOC
## POST /api/skills/install

### Description
Install a skill to your local environment.

### Method
POST

### Endpoint
/api/skills/install

### Parameters
#### Request Body
- **id** (string) - Required - Skill ID to install

### Request Example
{
  "id": "author/skill-name"
}

### Response
#### Success Response (200)
- **message** (string) - Confirmation message of successful installation.

#### Response Example
{
  "message": "Skill 'author/skill-name' installed successfully."
}
```

--------------------------------

### Install and Use Skillsmith CLI

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/public/llms.txt

Install the Skillsmith CLI globally using npm and then use commands to search, install, and list skills.

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

--------------------------------

### Install @skillsmith/mcp-server

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/mcp-server/README.md

Install the MCP server package using npm. This command is used for initial setup.

```bash
npm install @skillsmith/mcp-server
```

--------------------------------

### Install @skillsmith/core

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/core/README.md

Install the core library using npm. This is the first step to using Skillsmith's features.

```bash
npm install @skillsmith/core
```

--------------------------------

### Skill Bundle Configuration Example

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/src/content/blog/agent-skill-framework.md

Example package.json for a skill bundle, listing skills under a custom 'skills' array. This is used to group and distribute multiple skills.

```json
// package.json for your skill bundle
{
  "name": "@yourhandle/claude-skills-core",
  "version": "1.0.0",
  "description": "My standard Claude Code skill set",
  "dependencies": {},
  "skills": [
    "linear",
    "react-conventions",
    "testing-patterns",
    "security-review"
  ]
}
```

--------------------------------

### Create an MCP Server

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/README.md

Scaffolds a new MCP server project, installs dependencies, and provides instructions for starting the development server and client configuration.

```bash
# Scaffold a new MCP server
skillsmith author mcp-init my-slack-integration --tools "send_message,list_channels"

# Navigate and install dependencies
cd my-slack-integration
npm install

# Start development server
npm run dev

# Add to MCP client settings
# Edit ~/.claude/settings.json to include the server
```

--------------------------------

### MCP Server First Run Documentation Installation Log

Source: https://github.com/smith-horn/skillsmith/blob/main/RELEASE_NOTES.md

This log shows the output when the MCP server is first launched, indicating the automatic installation of essential documentation and skills.

```text
[skillsmith] First run detected, installing essentials...
[skillsmith] Installed bundled skill: skillsmith
[skillsmith] Installed user documentation to ~/.skillsmith/docs/
[skillsmith] Installed: varlock
[skillsmith] Installed: commit
[skillsmith] Installed: skill-builder
[skillsmith] Installed: governance

Welcome to Skillsmith!
```

--------------------------------

### Install a Skill

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/mcp-server/src/assets/skills/skillsmith/SKILL.md

Install a skill using its name. Skillsmith downloads, scans, and installs the skill to your local configuration.

```bash
"Install the commit skill"
```

--------------------------------

### Install Node Modules for Worktrees

Source: https://github.com/smith-horn/skillsmith/blob/main/CLAUDE.md

One-time host setup command to install Node.js dependencies, ignoring scripts. This is crucial for pre-commit hooks in worktrees to function correctly by populating the main repo's node_modules.

```bash
npm install --ignore-scripts
```

--------------------------------

### Install a Skill

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/assets/skillsmith-skill/SKILL.md

Installs a skill from the registry, with an option to force overwrite if it already exists.

```APIDOC
## POST /skillsmith/install_skill

### Description
Installs a skill from the registry.

### Method
POST

### Endpoint
/skillsmith/install_skill

### Parameters
#### Request Body
- **id** (string) - Required - The unique identifier of the skill to install (e.g., `author/name`).
- **force** (boolean) - Optional - If true, overwrites the skill if it already exists. Defaults to false.

### Request Example
```json
{
  "id": "community/jest-helper",
  "force": false
}
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message indicating the skill was installed successfully.

#### Response Example
```json
{
  "message": "Skill 'community/jest-helper' installed successfully."
}
```
```

--------------------------------

### Install MCP Server

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/public/llms-full.txt

Use this command to install the MCP server for AI assistants. This enables communication between the assistant and Skillsmith.

```bash
npx -y @skillsmith/mcp-server
```

--------------------------------

### Example: Browse Skills by Category

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/assets/skillsmith-skill/SKILL.md

This example shows how to search for skills within a specific category and trust tier using mcp__skillsmith__search.

```json
{ "category": "security", "trust_tier": "verified" }
```

--------------------------------

### Install Skill

Source: https://context7.com/smith-horn/skillsmith/llms.txt

Install a skill to the local skills directory, with options for security scanning and conflict resolution.

```APIDOC
## POST /api/skills/install

### Description
Install a skill from the registry or GitHub URL to `~/.claude/skills/` with security scanning, conflict resolution, and manifest tracking.

### Method
POST

### Endpoint
/api/skills/install

### Parameters
#### Request Body
- **skillId** (string) - Required - The identifier of the skill (e.g., 'anthropic/commit' or a GitHub URL).
- **force** (boolean) - Optional - Force reinstall if the skill already exists. Defaults to false.
- **skipScan** (boolean) - Optional - Skip security scanning. Not recommended. Defaults to false.
- **skipOptimize** (boolean) - Optional - Skip Skillsmith optimization. Defaults to false.
- **conflictAction** (string) - Optional - Action to take if a conflict occurs ('overwrite', 'merge', 'cancel'). Defaults to 'merge'.
- **confirmed** (boolean) - Optional - Required for experimental/unknown tiers. Defaults to false.

### Request Example
```json
{
  "skillId": "anthropic/commit"
}
```

```json
{
  "skillId": "https://github.com/user/my-skill",
  "force": false,
  "skipScan": false,
  "skipOptimize": false,
  "conflictAction": "merge",
  "confirmed": false
}
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the installation was successful.
- **skillId** (string) - The identifier of the installed skill.
- **installPath** (string) - The local path where the skill was installed.
- **trustTier** (string) - The trust tier of the installed skill.
- **securityReport** (object) - Report from the security scan.
  - **passed** (boolean) - Whether the security scan passed.
  - **riskScore** (integer) - The risk score.
  - **findings** (array) - List of security findings.
  - **scannedAt** (string) - Timestamp when the skill was scanned.
- **optimization** (object) - Information about skill optimization.
  - **optimized** (boolean) - Whether optimization was performed.
  - **tokenReductionPercent** (integer) - Percentage of token reduction.
  - **originalLines** (integer) - Original number of lines.
  - **optimizedLines** (integer) - Optimized number of lines.
- **tips** (array of strings) - Usage tips for the installed skill.
- **depIntel** (object) - Dependency intelligence.
  - **mcpServers** (array of strings) - List of MCP servers detected.
  - **npmPackages** (array of strings) - List of detected NPM packages.

#### Response Example
```json
{
  "success": true,
  "skillId": "anthropic/commit",
  "installPath": "/Users/me/.claude/skills/commit",
  "trustTier": "verified",
  "securityReport": {
    "passed": true,
    "riskScore": 5,
    "findings": [],
    "scannedAt": "2024-01-15T10:30:00Z"
  },
  "optimization": {
    "optimized": true,
    "tokenReductionPercent": 15,
    "originalLines": 150,
    "optimizedLines": 128
  },
  "tips": ["Use /commit to generate semantic commit messages"],
  "depIntel": {
    "mcpServers": ["@anthropic/mcp-sdk"],
    "npmPackages": []
  }
}
```
```

--------------------------------

### Install @skillsmith/cli Globally

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/README.md

Install the CLI globally using npm for system-wide access. Alternatively, use npx to run commands without global installation.

```bash
npm install -g @skillsmith/cli
```

```bash
npx @skillsmith/cli search "testing"
```

--------------------------------

### Install Skillsmith CLI and Login

Source: https://github.com/smith-horn/skillsmith/blob/main/README.md

Install the Skillsmith CLI globally using npm and log in interactively. This process opens a browser for authentication and securely stores the key in your OS keyring.

```bash
npm install -g @skillsmith/cli
skillsmith login
```

--------------------------------

### Install skillsmith-cli

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/skillsmith-cli/README.md

Install the skillsmith-cli globally using npm. This command is used to set up the command-line interface for skillsmith.

```bash
npm install -g skillsmith-cli
# or
npm install -g @skillsmith/cli
```

--------------------------------

### Example: Search for Testing Skills

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/assets/skillsmith-skill/SKILL.md

This example demonstrates searching for skills related to testing using the mcp__skillsmith__search tool.

```json
{ "query": "testing React" }
```

--------------------------------

### Install @skillsmith/enterprise Package

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/enterprise/README.md

Install the enterprise package using npm after configuring authentication for GitHub Packages.

```bash
npm install @skillsmith/enterprise
```

--------------------------------

### Check Installed Skills

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/mcp-server/src/assets/skills/skillsmith/SKILL.md

Query Skillsmith to list all currently installed skills.

```bash
"What skills do I have installed?"
```

--------------------------------

### Install Skillsmith CLI Package

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/public/llms.txt

Install the Skillsmith CLI package using npm.

```bash
npm i -g @skillsmith/cli
```

--------------------------------

### Local Development

Source: https://github.com/smith-horn/skillsmith/blob/main/apps/api-proxy/README.md

Command to start the Vercel development server for local testing.

```bash
vercel dev
# Access at http://localhost:3000
```

--------------------------------

### Install Skillsmith CLI

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/vscode-extension/resources/walkthrough/create.md

Install the Skillsmith CLI globally using npm. This command is required to use the `Skillsmith: Create Skill` command.

```bash
npm install -g @skillsmith/cli
```

--------------------------------

### Install Skill Stack via Plugin

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/src/content/blog/agent-skill-framework.md

Install a pre-composed skill bundle (e.g., your core package) using the 'claude plugin add' command.

```bash
# Install your entire skill stack
claude plugin add github:yourhandle/claude-skills-core
```

--------------------------------

### List Installed Skills

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/README.md

Display a list of installed skills, with an option to show detailed information using the --verbose flag.

```bash
skillsmith list

# With details
skillsmith list --verbose
```

--------------------------------

### Skillsmith CLI Install Command

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/assets/skillsmith-skill/SKILL.md

Install a skill from the community registry using the Skillsmith CLI. Specify the trust tier and skill name.

```bash
skillsmith install community/jest-helper
```

--------------------------------

### Skillsmith CLI: Install Skill

Source: https://context7.com/smith-horn/skillsmith/llms.txt

Install a skill either from the Skillsmith registry using an alias or from a GitHub repository URL. Options include forcing reinstallation and skipping security scans.

```bash
# Install from registry
skillsmith install anthropic/commit
```

```bash
# Install from GitHub URL
skillsmith install https://github.com/user/my-skill
```

```bash
# Force reinstall
skillsmith install anthropic/commit --force
```

```bash
# Skip security scan (not recommended)
skillsmith install untrusted/skill --skip-scan --confirmed
```

--------------------------------

### Install a Skill

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/README.md

Install a skill from a specified author and skill name. This command is an alias for the MCP server's install_skill function.

```bash
skillsmith install author/skill-name
```

--------------------------------

### Start and Manage Skillsmith Development Environment

Source: https://github.com/smith-horn/skillsmith/blob/main/CLAUDE.md

Use these commands to start, execute tasks within, and manage the Dockerized development environment for Skillsmith. All code execution must occur in Docker.

```bash
docker compose --profile dev up -d
```

```bash
docker exec skillsmith-dev-1 npm run build
```

```bash
docker exec skillsmith-dev-1 npm test
```

```bash
docker exec skillsmith-dev-1 npm run lint
```

```bash
docker exec skillsmith-dev-1 npm run typecheck
```

```bash
docker exec skillsmith-dev-1 npm run audit:standards
```

```bash
docker exec skillsmith-dev-1 npm run preflight
```

```bash
docker compose --profile dev down
```

```bash
docker logs skillsmith-dev-1
```

--------------------------------

### Install Optional Dependencies with npm

Source: https://github.com/smith-horn/skillsmith/blob/main/scripts/tests/fixtures/smi-3984-commit-body.txt

Use this command to install optional dependencies, including cross-platform variants, when facing issues with npm's default behavior. The `--force` flag may be necessary in certain scenarios.

```bash
npm install --os=linux --cpu=x64 --include=optional --force
```

--------------------------------

### Install Dependencies and Build After Pulling Changes

Source: https://github.com/smith-horn/skillsmith/blob/main/CLAUDE.md

Run these commands if the container is not running after pulling changes, especially if package-lock.json has been modified. This ensures dependencies are installed and the project is built.

```bash
docker exec skillsmith-dev-1 npm install && docker exec skillsmith-dev-1 npm run build
```

--------------------------------

### Docker Compose Development Environment

Source: https://github.com/smith-horn/skillsmith/blob/main/scripts/phases/README.md

Start the Docker Compose services for the development environment. Verify that the containers are running.

```bash
docker compose --profile dev up -d
docker ps | grep skillsmith  # Verify running
```

--------------------------------

### Initialize a New Skill Project

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/README.md

Start a new skill project using interactive prompts or by specifying the name and path. Supports different template options.

```bash
# Interactive mode
skillsmith init

# With name
skillsmith init my-skill

# In specific directory
skillsmith init my-skill --path ./skills/my-skill
```

--------------------------------

### Run Phase 2 Linear Setup Script

Source: https://github.com/smith-horn/skillsmith/blob/main/scripts/README.md

Executes the script to create the Phase 2 project and associated issues in Linear.

```bash
./scripts/linear-phase2-setup.sh
```

--------------------------------

### Get Skill Recommendations

Source: https://context7.com/smith-horn/skillsmith/llms.txt

Provides personalized skill recommendations based on installed skills and project context. Options include filtering by similarity, role, and detecting overlapping skills.

```typescript
const response = await executeRecommend({}, context);
```

```typescript
const response = await executeRecommend({
  installed_skills: ['anthropic/commit', 'community/jest-helper'],
  project_context: 'React frontend with TypeScript and Jest testing',
  limit: 10,                    // Max recommendations (default 5, max 50)
  detect_overlap: true,         // Filter similar skills
  min_similarity: 0.3,          // Similarity threshold (0-1)
  role: 'testing'               // code-quality, testing, documentation, workflow, security, development-partner
}, context);
```

```json
{
  recommendations: [{
    skill_id: 'community/vitest-helper',
    name: 'vitest-helper',
    reason: 'Matches your stack: jest, react, testing (role: testing)',
    similarity_score: 0.85,
    trust_tier: 'community',
    quality_score: 82,
    roles: ['testing', 'code-quality']
  }],
  candidates_considered: 150,
  overlap_filtered: 12,
  role_filtered: 45,
  context: {
    installed_count: 2,
    has_project_context: true,
    using_semantic_matching: true,
    auto_detected: false,
    role_filter: 'testing'
  },
  timing: { totalMs: 234 }
}
```

--------------------------------

### Get Skill Dependency Table

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/src/content/blog/dependency-intelligence.md

Use `get_skill` to retrieve the full dependency table for any skill in the registry. This helps users understand skill requirements before installation, including MCP servers, skill dependencies, and assumed model capabilities.

```bash
get_skill
```

--------------------------------

### Skill Repository Structure Example

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/src/content/blog/agent-skill-framework.md

Illustrates a recommended directory structure for organizing AI skill code, including main skill files, sub-skills, scripts, and hooks.

```tree
linear-claude-skill/
├── skills/linear/
│   ├── SKILL.md          # Main skill instructions (entry point)
│   ├── api.md            # GraphQL API reference (sub-skill)
│   ├── sdk.md            # SDK automation patterns (sub-skill)
│   ├── sync.md           # Bulk sync patterns (sub-skill)
│   ├── scripts/
│   │   ├── query.ts      # Deterministic GraphQL runner
│   │   ├── query.sh      # Shell wrapper
│   │   └── sync.ts       # Bulk sync CLI tool
│   └── hooks/
│       └── post-edit.sh  # Auto-sync hook
├── CHANGELOG.md          # Version history
├── LICENSE               # MIT
├── README.md             # Installation + usage
└── package.json          # npm metadata for distribution
```

--------------------------------

### Install Skillsmith CLI

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/public/llms-full.txt

Install the Skillsmith CLI globally using npm. This allows you to search and install skills directly from your terminal.

```bash
npm install -g @skillsmith/cli
skillsmith search testing
skillsmith install jest-helper
```

--------------------------------

### Troubleshoot Container Startup Issues

Source: https://github.com/smith-horn/skillsmith/blob/main/README.md

Steps to resolve issues when the Docker container fails to start, including downing the compose, removing volumes, and reinstalling dependencies.

```bash
docker compose --profile dev down
docker volume rm skillsmith_node_modules
docker compose --profile dev up -d
docker exec skillsmith-dev-1 npm install
```

--------------------------------

### Changelog Format Example

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/src/content/blog/agent-skill-framework.md

Demonstrates the recommended markdown format for documenting skill changes, including versioning, dates, and categorized updates (Added, Changed, Fixed).

```markdown
# Changelog

## [1.2.0] - 2025-01-20

### Added
- Bulk sync patterns via `sync.md`
- Hook-triggered sync after code edits

### Changed
- MCP reliability table updated with official Linear server

### Fixed
- GraphQL workaround for comment creation (MCP broken)

## [1.1.0] - 2025-01-15
...
```

--------------------------------

### List Installed Skills

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/assets/skillsmith-skill/SKILL.md

Retrieves a list of all skills currently installed.

```APIDOC
## GET /skillsmith/list

### Description
Lists all skills that are currently installed.

### Method
GET

### Endpoint
/skillsmith/list

### Response
#### Success Response (200)
- **installed_skills** (array) - A list of installed skills, each with its name and version.

#### Response Example
```json
{
  "installed_skills": [
    {
      "name": "jest-helper",
      "version": "1.0.0"
    },
    {
      "name": "vitest-helper",
      "version": "0.5.0"
    }
  ]
}
```
```

--------------------------------

### Initialize npm Package for Skill Bundling

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/src/content/blog/agent-skill-framework.md

Use 'npm init -y' to quickly create a package.json file for a new npm package that will bundle skills.

```bash
# Create your own skill bundle
npm init -y
# Add skills as dependencies or devDependencies
# npm install @yourorg/linear-skill @yourorg/react-skill
```

--------------------------------

### Wave-Based Feature Delivery Example

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/src/content/blog/building-skillsmith-claude-flow.md

Illustrates the sequential ordering of feature development waves, prioritizing database migrations and managing dependencies. Each wave builds upon the previous one, not directly from main, to minimize merge conflicts.

```text
Wave 1  DB migration         ← risk-first: schema before everything
Wave 2  Indexer changes      ← depends on Wave 1 columns
Wave 3  MCP tool updates     ← surfaces new fields to search
Wave 4  UI / docs            ← safe to parallelize last
```

--------------------------------

### Update All Installed Skills

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/README.md

Use this command to update all skills that are currently installed on your system.

```bash
skillsmith update
```

--------------------------------

### Initialize a New Skill for Authoring

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/README.md

Initializes a new skill directory structure for authoring, preparing it for validation and publishing.

```bash
# Initialize new skill
skillsmith init my-awesome-skill

# Edit the generated SKILL.md...

# Validate your skill
skillsmith validate ./my-awesome-skill

# Generate companion subagent for parallel execution
skillsmith author subagent ./my-awesome-skill

# Prepare for publishing
skillsmith publish ./my-awesome-skill
```

--------------------------------

### Install Skill with Dependency Intelligence

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/src/content/blog/dependency-intelligence.md

The `install_skill` command now returns dependency intelligence in its response, including detected MCP servers, declared dependencies, and warnings about potentially unconfigured MCP servers.

```bash
install_skill
```

--------------------------------

### Install Skill Parameters

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/assets/skillsmith-skill/SKILL.md

Use mcp__skillsmith__install_skill with the required skill ID and an optional force parameter to overwrite if the skill exists.

```json
{ "id": "community/jest-helper", "force": false }
```

--------------------------------

### Update Installed Skills

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/README.md

Update all installed skills to their latest versions or specify a particular skill to update.

```bash
# Update all skills
skillsmith update

# Update specific skill
skillsmith update author/skill-name
```

--------------------------------

### Alternative Execution with Haiku Model

Source: https://github.com/smith-horn/skillsmith/blob/main/scripts/swarm-phase-2e-followup.md

Demonstrates how to use the Haiku model for smaller issues and Sonnet for complex ones to optimize execution speed.

```bash
claude -p "..." --model haiku  # For Batch 1 (small issues)
claude -p "..." --model sonnet # For Batches 2-4 (complex issues)
```

--------------------------------

### Skillsmith CLI List Installed Skills

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/assets/skillsmith-skill/SKILL.md

View a list of skills currently installed via the Skillsmith CLI.

```bash
skillsmith list
```

--------------------------------

### Record User Interactions and Personalize Recommendations

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/core/src/learning/README.md

This TypeScript example demonstrates the core workflow of the Recommendation Learning Loop: recording user actions like accepting a recommendation, updating the user's preference profile, and then personalizing future recommendations based on learned weights. Ensure the necessary modules are imported from '@skillsmith/core/learning'.

```typescript
import { SignalCollector, PreferenceLearner, PersonalizationEngine } from '@skillsmith/core/learning'

// 1. Record user accepting a recommendation
const collector = new SignalCollector(dbPath)
await collector.recordAccept('anthropic/commit', {
  installed_skills: ['anthropic/review-pr'],
  original_score: 0.85,
  category: 'git',
})

// 2. Learn from signals
const learner = new PreferenceLearner(config)
const profile = await learner.updateProfile(currentProfile, signal)

// 3. Apply personalization to recommendations
const engine = new PersonalizationEngine(learner, profileStore)
const personalized = await engine.personalizeRecommendations(baseResults)

console.log(personalized[0].personalized_score) // 0.92 (boosted from 0.85)
```

--------------------------------

### Publish a Skill

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/cli/README.md

Prepare a skill for publishing or sharing with others. This command initiates the process for making a skill available.

```bash
skillsmith publish
```

--------------------------------

### Install Skillsmith CLI Globally

Source: https://github.com/smith-horn/skillsmith/blob/main/RELEASE_NOTES.md

Install the Skillsmith CLI globally using npm. Ensure you are using version 0.3.0 or later.

```bash
npm install -g @skillsmith/cli@0.3.0
```

--------------------------------

### Prepare Release Script

Source: https://github.com/smith-horn/skillsmith/blob/main/CLAUDE.md

Use these commands to prepare a new release by bumping versions, updating changelogs, and committing changes. The `--all` flag bumps all packages, while selective flags allow for specific package version updates. `--dry-run` previews changes without applying them.

```bash
docker exec skillsmith-dev-1 npx tsx scripts/prepare-release.ts --all=patch
```

```bash
docker exec skillsmith-dev-1 npx tsx scripts/prepare-release.ts --core=minor --cli=patch
```

```bash
docker exec skillsmith-dev-1 npx tsx scripts/prepare-release.ts --dry-run --all=patch
```

--------------------------------

### Pre-flight Checklist for Batch Execution

Source: https://github.com/smith-horn/skillsmith/blob/main/scripts/swarm-phase-2e-followup.md

A checklist of commands to run before starting any batch, ensuring Docker is running, the container is up, the build works, and Linear access is verified.

```bash
# 1. Ensure Docker is running
docker ps | grep skillsmith

# 2. Start container if needed
docker compose --profile dev up -d

# 3. Verify build works
docker exec skillsmith-dev-1 npm run typecheck

# 4. Check Linear access
docker exec skillsmith-dev-1 npm run linear:check 2>/dev/null || echo "Linear access OK"

# 5. Create fresh branch
git checkout -b feature/phase-2e-followup
```

--------------------------------

### Get Skill Recommendations using CLI

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/public/llms.txt

Use the 'skillsmith recommend' command to get skill suggestions based on your current project context.

```bash
skillsmith recommend
```

--------------------------------

### Skillsmith CLI: Author Init

Source: https://context7.com/smith-horn/skillsmith/llms.txt

Initialize a new skill project using predefined templates. Can create a skill in the current directory, specify a name, or initialize a specific project type like an MCP server skill.

```bash
# Create new skill in current directory
skillsmith author init
```

```bash
# Create with name
skillsmith author init my-skill
```

```bash
# Create MCP server skill project
skillsmith author mcp-init my-mcp-skill
```

--------------------------------

### Skill Scoring Formula Example

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/src/content/blog/how-skillsmith-indexes-skills.md

An example breakdown of how a skill's final score is calculated based on Popularity, Activity, Documentation, and Trust. This illustrates the weighting of each category.

```plaintext
Skill: community/react-test-helper

Popularity:    22/30 (85 stars, 12 forks, 8 watchers)
Activity:      23/25 (updated 5 days ago, active commits, responsive)
Documentation: 19/25 (good SKILL.md, has examples, clear description)
Trust:         15/20 (MIT license, topics set, not yet verified)

Final: 22 + 23 + 19 + 15 = 79/100

Trust Tier: Community (score > 40, scan passed)
```

--------------------------------

### Install Pre-commit Git Hook

Source: https://github.com/smith-horn/skillsmith/blob/main/scripts/README.md

Installs the pre-commit Git hook script to warn about untracked files in specific directories before each commit. This helps prevent common development issues.

```bash
# Copy to .git/hooks/
cp scripts/git-hooks/pre-commit-check-src.sh .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit
```

--------------------------------

### Manage Installed Skills via Bash

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/src/content/blog/security-quarantine-safe-installation.md

Provides bash commands for viewing installed skills in the user's directory, manually removing a skill, or using the Skillsmith CLI for uninstallation.

```bash
# View installed skills
ls ~/.claude/skills/

# Remove a skill manually
rm -rf ~/.claude/skills/suspicious-skill/

# Or use Skillsmith
"Uninstall the suspicious-skill"
```

--------------------------------

### Semantic Optimization Example (YAML)

Source: https://github.com/smith-horn/skillsmith/blob/main/packages/website/src/content/blog/how-skillsmith-indexes-skills.md

Illustrates how to improve a skill's description for better semantic search matching. A more detailed description with relevant keywords helps users find the skill through various search queries.

```yaml
# Instead of:
description: "A skill for tests"

# Write:
description: "Helps write Jest unit tests for React components with mocking and snapshot testing support"
```