skillslap-mcp 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 atapifire
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+# skillslap-mcp
+
+MCP server for the [SkillSlap](https://skillslap.com) agent skill marketplace. Search, install, compose, and publish skills from your AI coding agent.
+
+## Setup
+
+### Claude Code
+
+```bash
+claude mcp add skillslap -- npx skillslap-mcp
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "skillslap": {
+      "command": "npx",
+      "args": ["skillslap-mcp"],
+      "env": {
+        "SKILLSLAP_TOKEN": "your-token-here"
+      }
+    }
+  }
+}
+```
+
+### Cline
+
+Add to your MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "skillslap": {
+      "command": "npx",
+      "args": ["skillslap-mcp"],
+      "env": {
+        "SKILLSLAP_TOKEN": "your-token-here"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `SKILLSLAP_API_URL` | No | `https://skillslap.com` | API base URL |
+| `SKILLSLAP_TOKEN` | For publish/update/compose of private skills | — | Auth token from your SkillSlap account |
+
+## Tools
+
+### `search_skills`
+Search the marketplace for agent skills. Returns compact results with install URLs.
+
+- `query` (string) — Search query (omit to browse all)
+- `tags` (string) — Comma-separated tag filter
+- `invocation_type` (string) — `agent` | `user` | `tool` | `context`
+- `sort` (string) — `relevance` | `trending` | `recent` | `slaps` | `focus_pool`
+- `limit` (number) — Max results (default: 10, max: 50)
+- `verified` (boolean) — Only return verified skills
+
+### `get_skill`
+Get details for a specific skill by ID with tiered data loading.
+
+- `id` (string, required) — Skill UUID
+- `tier` (number) — `1` = metadata, `2` = full (default), `3` = with files
+
+### `install_skill`
+Download a skill formatted for your agent, ready to save.
+
+- `id` (string, required) — Skill UUID
+- `agent` (string) — Agent name: `claude-code`, `cursor`, `cline`, `codex`, `windsurf`, `aider`, `copilot`, `gemini-cli`, `vscode`
+
+### `list_versions`
+Get version history for a skill with change summaries.
+
+- `id` (string, required) — Skill UUID
+
+### `publish_skill`
+Publish a new skill to the marketplace. Requires `SKILLSLAP_TOKEN`.
+
+- `title` (string, required) — Skill title (1-100 chars)
+- `content` (string, required) — Skill content in Markdown
+- `description` (string) — Short description (max 500 chars)
+- `tags` (string[]) — Tags (max 10)
+- `invocation_type` (string) — `agent` | `user` | `tool` | `context`
+- `status` (string) — `draft` | `active`
+
+### `update_skill`
+Update a skill you own. Requires `SKILLSLAP_TOKEN`.
+
+- `id` (string, required) — Skill UUID
+- `title` (string) — New title
+- `content` (string) — New content in Markdown
+- `description` (string) — New description
+- `tags` (string[]) — New tag list (replaces existing)
+- `status` (string) — `draft` | `active` | `archived`
+- `version` (string) — New version string (e.g. `"1.1.0"`)
+- `change_summary` (string) — What changed (stored in version history)
+
+### `generate_skill`
+Generate a skill from a natural language description using AI. Requires `SKILLSLAP_TOKEN` and a BYOK Anthropic API key configured on your account.
+
+- `prompt` (string, required) — Description of the skill to generate (10-2000 chars)
+- `auto_publish` (boolean) — Publish immediately (default: false, returns draft for review)
+
+### `compose_skills`
+Compose multiple skills into a CLAUDE.md + agent_docs structure. No auth required for public skills.
+
+- `skill_ids` (string[], required) — Array of skill UUIDs to compose
+- `project_name` (string) — Optional project name for the output
+
+## CLI
+
+The package also installs a `skillslap` CLI for use in terminals and scripts.
+
+```bash
+skillslap search "code review"
+skillslap search testing --verified --limit=5
+skillslap install <skill-id>
+skillslap install <skill-id> --agent=claude-code
+skillslap list
+skillslap publish ./SKILL.md --tags="python,testing" --status=active
+```
+
+## Usage Example
+
+```
+You: Search for testing skills
+Agent: [calls search_skills with query "testing"]
+
+You: Install the first one
+Agent: [calls install_skill with the skill ID]
+
+You: Update that skill with improved content
+Agent: [calls update_skill with the skill ID and new content]
+
+You: Compose these two skills into my project
+Agent: [calls compose_skills with skill IDs]
+```
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,80 @@
+export interface SearchResult {
+    id: string;
+    name: string;
+    title: string;
+    description: string | null;
+    version: string;
+    tags: string[];
+    author: string;
+    verification: {
+        status: string | null;
+        score: number | null;
+    };
+    slap_count: number;
+    invocation_type: string;
+    install_url: string;
+    export_url: string;
+}
+export interface SearchResponse {
+    query: string;
+    results: SearchResult[];
+    total: number;
+}
+export interface GeneratedSkill {
+    title: string;
+    description: string;
+    content: string;
+    tags: string[];
+    invocation_type: string;
+}
+export interface SkillVersion {
+    id: string;
+    skill_id: string;
+    version: string;
+    change_summary: string | null;
+    created_at: string;
+}
+export declare class SkillSlapClient {
+    private baseUrl;
+    private token?;
+    constructor(baseUrl: string, token?: string);
+    private fetch;
+    searchSkills(q: string, opts?: {
+        tags?: string;
+        invocationType?: string;
+        sort?: string;
+        limit?: number;
+        verified?: boolean;
+    }): Promise<SearchResponse>;
+    getSkill(id: string, tier?: number): Promise<any>;
+    installSkill(id: string, agent?: string): Promise<string>;
+    listVersions(id: string): Promise<{
+        versions: SkillVersion[];
+    }>;
+    composeSkills(skillIds: string[], projectName?: string): Promise<{
+        claude_md: string;
+        agent_docs: Record<string, string>;
+        skills: Array<{
+            id: string;
+            title: string;
+        }>;
+    }>;
+    generateSkill(prompt: string): Promise<GeneratedSkill>;
+    publishSkill(data: {
+        title: string;
+        content: string;
+        description?: string;
+        tags?: string[];
+        invocation_type?: string;
+        status?: string;
+    }): Promise<any>;
+    updateSkill(id: string, data: {
+        title?: string;
+        content?: string;
+        description?: string | null;
+        tags?: string[];
+        status?: string;
+        version?: string;
+        change_summary?: string;
+    }): Promise<any>;
+}

package/dist/api-client.js

@@ -0,0 +1,138 @@
+export class SkillSlapClient {
+    baseUrl;
+    token;
+    constructor(baseUrl, token) {
+        // Remove trailing slash
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.token = token;
+    }
+    async fetch(path, options) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Accept': 'application/json',
+            ...(options?.headers || {}),
+        };
+        if (this.token) {
+            headers['Authorization'] = `Bearer ${this.token}`;
+        }
+        const response = await fetch(url, {
+            ...options,
+            headers,
+        });
+        return response;
+    }
+    async searchSkills(q, opts) {
+        const params = new URLSearchParams();
+        if (q)
+            params.set('q', q);
+        if (opts?.tags)
+            params.set('tags', opts.tags);
+        if (opts?.invocationType)
+            params.set('invocation_type', opts.invocationType);
+        if (opts?.sort)
+            params.set('sort', opts.sort);
+        if (opts?.limit)
+            params.set('limit', String(opts.limit));
+        if (opts?.verified)
+            params.set('verified', 'true');
+        const res = await this.fetch(`/api/v1/skills/search?${params}`);
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({ error: res.statusText }));
+            throw new Error(`Search failed (${res.status}): ${err.error || res.statusText}`);
+        }
+        return res.json();
+    }
+    async getSkill(id, tier) {
+        const params = new URLSearchParams();
+        if (tier)
+            params.set('tier', String(tier));
+        const qs = params.toString();
+        const res = await this.fetch(`/api/v1/skills/${id}${qs ? `?${qs}` : ''}`);
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({ error: res.statusText }));
+            throw new Error(`Get skill failed (${res.status}): ${err.error || res.statusText}`);
+        }
+        return res.json();
+    }
+    async installSkill(id, agent) {
+        const params = new URLSearchParams();
+        if (agent)
+            params.set('agent', agent);
+        const qs = params.toString();
+        const res = await this.fetch(`/api/v1/skills/${id}/install${qs ? `?${qs}` : ''}`);
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({ error: res.statusText }));
+            throw new Error(`Install failed (${res.status}): ${err.error || res.statusText}`);
+        }
+        return res.text();
+    }
+    async listVersions(id) {
+        const res = await this.fetch(`/api/v1/skills/${id}/versions`);
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({ error: res.statusText }));
+            throw new Error(`List versions failed (${res.status}): ${err.error || res.statusText}`);
+        }
+        return res.json();
+    }
+    async composeSkills(skillIds, projectName) {
+        const body = { skill_ids: skillIds };
+        if (projectName)
+            body.project_name = projectName;
+        const res = await this.fetch('/api/v1/skills/compose', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({ error: res.statusText }));
+            throw new Error(`Compose failed (${res.status}): ${err.error || res.statusText}`);
+        }
+        return res.json();
+    }
+    async generateSkill(prompt) {
+        if (!this.token) {
+            throw new Error('Authentication required to generate skills. Set SKILLSLAP_TOKEN.');
+        }
+        const res = await this.fetch('/api/v1/skills/generate', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ prompt }),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({ error: res.statusText }));
+            throw new Error(`Generate failed (${res.status}): ${err.error || res.statusText}`);
+        }
+        return res.json();
+    }
+    async publishSkill(data) {
+        if (!this.token) {
+            throw new Error('Authentication required to publish skills. Set SKILLSLAP_TOKEN.');
+        }
+        const res = await this.fetch('/api/v1/skills', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(data),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({ error: res.statusText }));
+            throw new Error(`Publish failed (${res.status}): ${err.error || res.statusText}`);
+        }
+        return res.json();
+    }
+    async updateSkill(id, data) {
+        if (!this.token) {
+            throw new Error('Authentication required to update skills. Set SKILLSLAP_TOKEN.');
+        }
+        const res = await this.fetch(`/api/v1/skills/${id}`, {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(data),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({ error: res.statusText }));
+            throw new Error(`Update failed (${res.status}): ${err.error || res.statusText}`);
+        }
+        return res.json();
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import { SkillSlapClient } from './api-client.js';
+export declare function slugify(title: string): string;
+export interface InstalledEntry {
+    id: string;
+    title: string;
+    version: string;
+    path: string;
+    installedAt: string;
+}
+export interface Manifest {
+    installed: InstalledEntry[];
+}
+export declare function readManifest(manifestPath: string): Manifest;
+export declare function list(flags: {
+    dir?: string;
+}): void;
+export declare function publish(client: SkillSlapClient, filePath: string, flags: {
+    title?: string;
+    description?: string;
+    tags?: string;
+    status?: string;
+}): Promise<{
+    id: string;
+    title: string;
+}>;
+export declare function install(client: SkillSlapClient, id: string, flags: {
+    agent?: string;
+    dir?: string;
+}): Promise<{
+    outPath: string;
+    manifestPath: string;
+    title: string;
+}>;
+export declare function search(client: SkillSlapClient, query: string, flags: {
+    limit?: number;
+    verified?: boolean;
+}): Promise<void>;
+export declare function parseArgs(argv: string[]): {
+    cmd: string | undefined;
+    positional: string[];
+    flags: Record<string, string | boolean>;
+};

package/dist/cli.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { SkillSlapClient } from './api-client.js';
+const API_URL = process.env.SKILLSLAP_API_URL || 'https://skillslap.com';
+const TOKEN = process.env.SKILLSLAP_TOKEN;
+// ── Helpers ──────────────────────────────────────────────────────────────────
+export function slugify(title) {
+    return title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+}
+export function readManifest(manifestPath) {
+    if (existsSync(manifestPath)) {
+        try {
+            return JSON.parse(readFileSync(manifestPath, 'utf8'));
+        }
+        catch {
+            // Corrupted manifest — start fresh
+        }
+    }
+    return { installed: [] };
+}
+// ── Commands ─────────────────────────────────────────────────────────────────
+export function list(flags) {
+    const dir = flags.dir ? resolve(flags.dir) : process.cwd();
+    const manifestPath = join(dir, '.skillslap', 'installed.json');
+    const manifest = readManifest(manifestPath);
+    if (manifest.installed.length === 0) {
+        console.log('No skills installed. Run "skillslap install <skill-id>" to get started.');
+        return;
+    }
+    console.log(`Installed skills (${manifest.installed.length}):\n`);
+    manifest.installed.forEach((s) => {
+        const date = new Date(s.installedAt).toISOString().slice(0, 10);
+        console.log(`  ${s.title} v${s.version}`);
+        console.log(`  ID: ${s.id}`);
+        console.log(`  Path: ${s.path}  (installed ${date})`);
+        console.log();
+    });
+}
+export async function publish(client, filePath, flags) {
+    if (!existsSync(filePath)) {
+        throw new Error(`File not found: ${filePath}`);
+    }
+    const content = readFileSync(filePath, 'utf8');
+    // Derive title from first H1 if not provided
+    const title = flags.title || content.match(/^#\s+(.+)/m)?.[1]?.trim();
+    if (!title) {
+        throw new Error('Could not determine title. Add --title="..." or include a # H1 heading in the file.');
+    }
+    const tags = flags.tags ? flags.tags.split(',').map((t) => t.trim()).filter(Boolean) : undefined;
+    const result = await client.publishSkill({
+        title,
+        content,
+        description: flags.description,
+        tags,
+        status: flags.status || 'draft',
+    });
+    return { id: result.id, title };
+}
+export async function install(client, id, flags) {
+    const dir = flags.dir ? resolve(flags.dir) : process.cwd();
+    // Fetch skill metadata (tier 1 = lightweight)
+    const skill = await client.getSkill(id, 1);
+    const content = await client.installSkill(id, flags.agent);
+    const slug = slugify(skill.title || id);
+    const isContext = skill.invocation_type === 'context';
+    let outPath;
+    if (isContext) {
+        outPath = join(dir, 'CLAUDE.md');
+    }
+    else {
+        const agentDocsDir = join(dir, 'agent_docs');
+        mkdirSync(agentDocsDir, { recursive: true });
+        outPath = join(agentDocsDir, `${slug}.md`);
+    }
+    writeFileSync(outPath, content, 'utf8');
+    // Update .skillslap/installed.json manifest
+    const manifestDir = join(dir, '.skillslap');
+    const manifestPath = join(manifestDir, 'installed.json');
+    mkdirSync(manifestDir, { recursive: true });
+    const manifest = readManifest(manifestPath);
+    manifest.installed = manifest.installed.filter((s) => s.id !== id);
+    manifest.installed.push({
+        id,
+        title: skill.title || slug,
+        version: skill.version || '1.0.0',
+        path: isContext ? 'CLAUDE.md' : `agent_docs/${slug}.md`,
+        installedAt: new Date().toISOString(),
+    });
+    writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), 'utf8');
+    return { outPath, manifestPath, title: skill.title || slug };
+}
+export async function search(client, query, flags) {
+    const result = await client.searchSkills(query, {
+        limit: flags.limit,
+        verified: flags.verified,
+    });
+    if (result.results.length === 0) {
+        console.log(query ? `No skills found for "${query}"` : 'No skills found.');
+        return;
+    }
+    const header = query
+        ? `Found ${result.total} skill${result.total === 1 ? '' : 's'} for "${query}"`
+        : `Browsing ${result.total} skill${result.total === 1 ? '' : 's'}`;
+    console.log(`${header}${flags.verified ? ' (verified only)' : ''}\n`);
+    result.results.forEach((s, i) => {
+        const badge = s.verification.status === 'passed' ? '✅' : '⬜';
+        console.log(`${i + 1}. ${badge} ${s.title} v${s.version} by @${s.author}`);
+        if (s.description)
+            console.log(`   ${s.description.slice(0, 100)}`);
+        console.log(`   ID: ${s.id}`);
+        console.log(`   Install: skillslap install ${s.id}`);
+        console.log();
+    });
+}
+// ── Help ──────────────────────────────────────────────────────────────────────
+function printHelp() {
+    console.log(`
+SkillSlap CLI — discover and install agent skills
+
+Commands:
+  skillslap install <skill-id>  Install a skill into the current project
+  skillslap list                Show all installed skills in this project
+  skillslap search <query>      Search the marketplace (omit query to browse all)
+  skillslap publish <file>      Publish a skill from a local markdown file
+  skillslap help                Show this help
+
+Install options:
+  --agent=<name>   Agent type (claude-code, cursor, cline, etc.) — auto-detected
+  --dir=<path>     Target directory (default: current directory)
+
+List options:
+  --dir=<path>     Project directory to read manifest from (default: current directory)
+
+Search options:
+  --limit=<n>      Max results (default: 10, max: 50)
+  --verified       Only show verified skills
+
+Publish options:
+  --title=<title>  Skill title (auto-detected from # H1 if omitted)
+  --description=<desc>  Short description
+  --tags=<a,b,c>   Comma-separated tags
+  --status=draft|active  Publication status (default: draft)
+
+Environment:
+  SKILLSLAP_API_URL   API base URL (default: https://skillslap.com)
+  SKILLSLAP_TOKEN     Auth token for authenticated skills
+
+Examples:
+  skillslap search "code review"
+  skillslap search testing --verified --limit=5
+  skillslap install 550e8400-e29b-41d4-a716-446655440000
+  skillslap install 550e8400-... --agent=claude-code --dir=./my-project
+  skillslap list
+  skillslap publish ./SKILL.md --tags="python,testing" --status=active
+`.trim());
+}
+// ── Arg parser ────────────────────────────────────────────────────────────────
+export function parseArgs(argv) {
+    const [, , cmd, ...rest] = argv;
+    const flags = {};
+    const positional = [];
+    for (const arg of rest) {
+        if (arg.startsWith('--')) {
+            const eqIdx = arg.indexOf('=');
+            if (eqIdx !== -1) {
+                flags[arg.slice(2, eqIdx)] = arg.slice(eqIdx + 1);
+            }
+            else {
+                flags[arg.slice(2)] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { cmd, positional, flags };
+}
+// ── Main entry ────────────────────────────────────────────────────────────────
+async function main() {
+    const { cmd, positional, flags } = parseArgs(process.argv);
+    const client = new SkillSlapClient(API_URL, TOKEN);
+    if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
+        printHelp();
+        return;
+    }
+    if (cmd === 'install') {
+        const id = positional[0];
+        if (!id) {
+            console.error('Error: skill ID required\n\nUsage: skillslap install <skill-id>');
+            process.exit(1);
+        }
+        const { outPath, manifestPath, title } = await install(client, id, {
+            agent: flags.agent,
+            dir: flags.dir,
+        });
+        console.log(`✅ Installed: ${title}`);
+        console.log(`   File: ${outPath}`);
+        console.log(`   Manifest: ${manifestPath}`);
+        return;
+    }
+    if (cmd === 'search') {
+        await search(client, positional.join(' '), {
+            limit: flags.limit ? parseInt(flags.limit, 10) : undefined,
+            verified: !!flags.verified,
+        });
+        return;
+    }
+    if (cmd === 'list') {
+        list({ dir: flags.dir });
+        return;
+    }
+    if (cmd === 'publish') {
+        const filePath = positional[0];
+        if (!filePath) {
+            console.error('Error: file path required\n\nUsage: skillslap publish <file>');
+            process.exit(1);
+        }
+        const { id, title } = await publish(client, resolve(filePath), {
+            title: flags.title,
+            description: flags.description,
+            tags: flags.tags,
+            status: flags.status,
+        });
+        console.log(`✅ Published: ${title}`);
+        console.log(`   ID: ${id}`);
+        console.log(`   View: https://skillslap.com/skill/${id}`);
+        return;
+    }
+    console.error(`Unknown command: "${cmd}"\n\nRun "skillslap help" for usage.`);
+    process.exit(1);
+}
+// Only run when executed directly (not when imported by tests)
+const isMain = process.argv[1] === fileURLToPath(import.meta.url);
+if (isMain) {
+    main().catch((err) => {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { SkillSlapClient } from './api-client.js';
+import { createMcpServer } from './server.js';
+const API_URL = process.env.SKILLSLAP_API_URL || 'https://skillslap.com';
+const TOKEN = process.env.SKILLSLAP_TOKEN;
+const client = new SkillSlapClient(API_URL, TOKEN);
+const server = createMcpServer(client);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error('MCP server error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,uBAAuB,CAAA;AACxE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAA;AAEzC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;AAClD,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;AAEtC,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAA;IACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SkillSlapClient } from './api-client.js';
+export declare function createMcpServer(client: SkillSlapClient): Server;

package/dist/server.js

@@ -0,0 +1,52 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { tools } from './tools.js';
+export function createMcpServer(client) {
+    const server = new Server({
+        name: 'skillslap-mcp',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: tools.map((t) => ({
+                name: t.name,
+                description: t.description,
+                inputSchema: t.inputSchema,
+            })),
+        };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const tool = tools.find((t) => t.name === name);
+        if (!tool) {
+            return {
+                content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+                isError: true,
+            };
+        }
+        try {
+            const result = await tool.handler(args || {}, client);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAClE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAA;AAE3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAA;IAED,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC1D,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;aAC3B,CAAC,CAAC;SACJ,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAA;QAEhD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;QAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;gBAC1D,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,MAAM,CAAC,CAAA;YACrD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC5E;iBACF;aACF,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACtE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;gBACtD,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,8 @@
+import type { SkillSlapClient } from './api-client.js';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    handler: (args: Record<string, unknown>, client: SkillSlapClient) => Promise<unknown>;
+}
+export declare const tools: ToolDefinition[];

package/dist/tools.js

@@ -0,0 +1,361 @@
+import { z } from 'zod';
+// ── Output formatters (D.2: markdown for LLM consumption) ────────────────────
+function verificationBadge(status, score) {
+    if (status === 'passed' && score !== null)
+        return `✅ Verified ${Math.round(score * 100)}%`;
+    if (status === 'failed')
+        return '❌ Failed verification';
+    if (status === 'running')
+        return '⏳ Verifying...';
+    return '⬜ Unverified';
+}
+function formatSearchResults(data, opts = {}) {
+    const { results, total, query } = data;
+    if (results.length === 0) {
+        const subject = query ? `"${query}"` : 'your filters';
+        return `No skills found for ${subject}.`;
+    }
+    const header = query
+        ? `Found ${total} skill${total === 1 ? '' : 's'} for "${query}"${opts.verified ? ' · verified only' : ''}`
+        : `Browsing ${total} skill${total === 1 ? '' : 's'}${opts.verified ? ' · verified only' : ''}`;
+    const lines = [header, ''];
+    results.forEach((s, i) => {
+        const tags = s.tags.length > 0 ? s.tags.map((t) => `\`${t}\``).join(' ') : 'none';
+        const desc = s.description ? `> ${s.description.slice(0, 120)}${s.description.length > 120 ? '…' : ''}` : '';
+        lines.push(`${i + 1}. **${s.title}** v${s.version} · by @${s.author}`);
+        lines.push(`   ${verificationBadge(s.verification.status, s.verification.score)} · ${s.slap_count} slaps · ${s.invocation_type}`);
+        lines.push(`   Tags: ${tags}`);
+        if (desc)
+            lines.push(`   ${desc}`);
+        lines.push(`   To install: use \`install_skill\` with id \`${s.id}\``);
+        lines.push('');
+    });
+    return lines.join('\n').trim();
+}
+function formatSkillDetail(skill, tier) {
+    const vBadge = verificationBadge(skill.latest_verification_status ?? null, skill.latest_verification_score ?? null);
+    const tags = (skill.tags || []).map((t) => `\`${t}\``).join(' ') || 'none';
+    const author = skill.author?.username ?? 'unknown';
+    const lines = [
+        `# ${skill.title} v${skill.version ?? '1.0.0'}`,
+        '',
+        `**Author:** @${author} | **Status:** ${skill.status ?? 'active'} | **Invocation:** ${skill.invocation_type ?? 'agent'}`,
+        `**${vBadge}** | **Slaps:** ${skill.slap_count ?? 0} | **Focus Pool:** $${skill.focus_pool ?? 0}`,
+        `**Tags:** ${tags}`,
+        '',
+    ];
+    if (skill.description) {
+        lines.push(`> ${skill.description}`, '');
+    }
+    if (tier >= 2 && skill.content) {
+        lines.push('---', '', skill.content, '', '---', '');
+    }
+    if (tier >= 3 && skill.skill_files?.length > 0) {
+        lines.push(`**Files (${skill.skill_files.length}):**`);
+        skill.skill_files.forEach((f) => lines.push(`- \`${f.file_name}\` (${f.mime_type})`));
+        lines.push('');
+    }
+    lines.push(`**Install:** \`install_skill\` with id \`${skill.id}\``);
+    lines.push(`**ID:** \`${skill.id}\``);
+    return lines.join('\n');
+}
+function formatComposeResult(result, skillIds) {
+    const { claude_md, agent_docs, skills } = result;
+    const fileCount = Object.keys(agent_docs).length;
+    const total = 1 + fileCount;
+    const lines = [
+        `# Composed ${skillIds.length} Skill${skillIds.length === 1 ? '' : 's'} → ${total} File${total === 1 ? '' : 's'}`,
+        '',
+    ];
+    // Skills summary
+    if (skills && skills.length > 0) {
+        lines.push('**Skills included:**');
+        for (const s of skills) {
+            lines.push(`- **${s.title}** · \`${s.id}\``);
+        }
+        lines.push('');
+    }
+    lines.push('## Option A — Full project structure (CLAUDE.md + agent_docs)', '', '**Step 1:** Write the following to `CLAUDE.md` in your project root:', '', '```markdown', claude_md, '```', '');
+    if (fileCount > 0) {
+        lines.push(`**Step 2:** Create ${fileCount} file${fileCount === 1 ? '' : 's'} in \`agent_docs/\`:`);
+        lines.push('');
+        for (const [filename, content] of Object.entries(agent_docs)) {
+            lines.push(`### \`agent_docs/${filename}\``);
+            lines.push('');
+            lines.push('```markdown');
+            lines.push(content);
+            lines.push('```');
+            lines.push('');
+        }
+    }
+    lines.push('---', '');
+    lines.push('## Option B — Install each skill individually (simpler)', '');
+    lines.push('Run these commands in your project directory:', '', '```bash');
+    if (skills && skills.length > 0) {
+        for (const s of skills) {
+            lines.push(`skillslap install ${s.id}  # ${s.title}`);
+        }
+    }
+    else {
+        for (const id of skillIds) {
+            lines.push(`skillslap install ${id}`);
+        }
+    }
+    lines.push('```', '');
+    lines.push('---', '');
+    lines.push(`✅ Your agent will have access to all ${skillIds.length} composed skill${skillIds.length === 1 ? '' : 's'}.`);
+    return lines.join('\n');
+}
+function formatVersions(data, skillId) {
+    const { versions } = data;
+    if (versions.length === 0)
+        return `No version history for skill \`${skillId}\`.`;
+    const lines = [`# Version History (${versions.length} version${versions.length === 1 ? '' : 's'})`, ''];
+    for (const v of versions) {
+        const date = new Date(v.created_at).toISOString().slice(0, 10);
+        lines.push(`## v${v.version} · ${date}`);
+        if (v.change_summary)
+            lines.push(`> ${v.change_summary}`);
+        lines.push(`ID: \`${v.id}\``, '');
+    }
+    return lines.join('\n').trim();
+}
+export const tools = [
+    {
+        name: 'search_skills',
+        description: 'Search or browse the SkillSlap marketplace for agent skills. Omit query to browse all skills. Returns formatted markdown results.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query (optional — omit to browse all skills)' },
+                tags: { type: 'string', description: 'Comma-separated tag filter (optional)' },
+                invocation_type: {
+                    type: 'string',
+                    enum: ['agent', 'user', 'tool', 'context'],
+                    description: 'Filter by invocation type (optional)',
+                },
+                sort: {
+                    type: 'string',
+                    enum: ['relevance', 'trending', 'recent', 'slaps', 'focus_pool'],
+                    description: 'Sort order (default: relevance)',
+                },
+                limit: { type: 'number', description: 'Max results (default: 10, max: 50)' },
+                verified: { type: 'boolean', description: 'If true, return only verified skills' },
+            },
+            required: [],
+        },
+        handler: async (args, client) => {
+            const query = args.query ? z.string().parse(args.query) : '';
+            const tags = args.tags ? z.string().parse(args.tags) : undefined;
+            const invocationType = args.invocation_type ? z.string().parse(args.invocation_type) : undefined;
+            const sort = args.sort ? z.string().parse(args.sort) : undefined;
+            const limit = args.limit ? z.number().int().min(1).max(50).parse(args.limit) : undefined;
+            const verified = args.verified ? z.boolean().parse(args.verified) : undefined;
+            const result = await client.searchSkills(query, { tags, invocationType, sort, limit, verified });
+            return formatSearchResults(result, { verified: verified ?? false });
+        },
+    },
+    {
+        name: 'get_skill',
+        description: 'Get details for a specific skill by ID. Use tier 1 for metadata only, tier 2 for full content, tier 3 for content + files.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Skill UUID' },
+                tier: {
+                    type: 'number',
+                    enum: [1, 2, 3],
+                    description: 'Data tier: 1=metadata, 2=full (default), 3=with files',
+                },
+            },
+            required: ['id'],
+        },
+        handler: async (args, client) => {
+            const id = z.string().uuid().parse(args.id);
+            const tier = args.tier ? z.number().int().min(1).max(3).parse(args.tier) : undefined;
+            const result = await client.getSkill(id, tier);
+            return formatSkillDetail(result, tier ?? 2);
+        },
+    },
+    {
+        name: 'install_skill',
+        description: 'Download a skill in the best format for your agent. Returns the formatted skill content ready to save.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Skill UUID' },
+                agent: {
+                    type: 'string',
+                    description: 'Agent name (auto-detected from User-Agent if omitted). Options: claude-code, cursor, cline, codex, windsurf, aider, copilot, gemini-cli, vscode',
+                },
+            },
+            required: ['id'],
+        },
+        handler: async (args, client) => {
+            const id = z.string().uuid().parse(args.id);
+            const agent = args.agent ? z.string().parse(args.agent) : undefined;
+            return client.installSkill(id, agent);
+        },
+    },
+    {
+        name: 'list_versions',
+        description: 'Get version history for a skill. Shows all past versions with change summaries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Skill UUID' },
+            },
+            required: ['id'],
+        },
+        handler: async (args, client) => {
+            const id = z.string().uuid().parse(args.id);
+            const result = await client.listVersions(id);
+            return formatVersions(result, id);
+        },
+    },
+    {
+        name: 'publish_skill',
+        description: 'Publish a new skill to the SkillSlap marketplace. Requires SKILLSLAP_TOKEN for authentication.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: { type: 'string', description: 'Skill title (1-100 chars)' },
+                content: { type: 'string', description: 'Skill content in Markdown' },
+                description: { type: 'string', description: 'Short description (max 500 chars)' },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Tags (max 10)',
+                },
+                invocation_type: {
+                    type: 'string',
+                    enum: ['agent', 'user', 'tool', 'context'],
+                    description: 'How the skill is invoked (default: agent)',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['draft', 'active'],
+                    description: 'Initial status (default: draft)',
+                },
+            },
+            required: ['title', 'content'],
+        },
+        handler: async (args, client) => {
+            const data = {
+                title: z.string().min(1).max(100).parse(args.title),
+                content: z.string().min(1).parse(args.content),
+                description: args.description ? z.string().max(500).parse(args.description) : undefined,
+                tags: args.tags ? z.array(z.string()).max(10).parse(args.tags) : undefined,
+                invocation_type: args.invocation_type ? z.string().parse(args.invocation_type) : undefined,
+                status: args.status ? z.string().parse(args.status) : undefined,
+            };
+            return client.publishSkill(data);
+        },
+    },
+    {
+        name: 'update_skill',
+        description: 'Update an existing skill you own. Requires SKILLSLAP_TOKEN. Use change_summary to document what changed (shown in version history).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Skill UUID to update' },
+                title: { type: 'string', description: 'New title (1-100 chars)' },
+                content: { type: 'string', description: 'New skill content in Markdown' },
+                description: { type: 'string', description: 'New short description (max 500 chars)' },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'New tag list (max 10, replaces existing)',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['draft', 'active', 'archived'],
+                    description: 'New status',
+                },
+                version: { type: 'string', description: 'New version string (e.g. "1.1.0")' },
+                change_summary: { type: 'string', description: 'What changed in this update (max 500 chars, stored in version history)' },
+            },
+            required: ['id'],
+        },
+        handler: async (args, client) => {
+            const id = z.string().uuid().parse(args.id);
+            const data = {
+                title: args.title ? z.string().min(1).max(100).parse(args.title) : undefined,
+                content: args.content ? z.string().min(1).parse(args.content) : undefined,
+                description: args.description !== undefined ? z.string().max(500).nullable().parse(args.description) : undefined,
+                tags: args.tags ? z.array(z.string()).max(10).parse(args.tags) : undefined,
+                status: args.status ? z.string().parse(args.status) : undefined,
+                version: args.version ? z.string().max(50).parse(args.version) : undefined,
+                change_summary: args.change_summary ? z.string().max(500).parse(args.change_summary) : undefined,
+            };
+            // Strip keys that are undefined to avoid sending them
+            const payload = Object.fromEntries(Object.entries(data).filter(([, v]) => v !== undefined));
+            const result = await client.updateSkill(id, payload);
+            const lines = [
+                `✅ Updated: **${result.title}** v${result.version}`,
+                `**Status:** ${result.status} | **Tags:** ${(result.tags || []).map((t) => `\`${t}\``).join(' ') || 'none'}`,
+                `**ID:** \`${result.id}\``,
+                `**View:** https://skillslap.com/skill/${result.id}`,
+            ];
+            return lines.join('\n');
+        },
+    },
+    {
+        name: 'generate_skill',
+        description: 'Generate a complete skill from a natural language description using AI. Requires SKILLSLAP_TOKEN and a BYOK Anthropic API key configured on the account. Optionally auto-publish the generated skill.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                prompt: { type: 'string', description: 'Natural language description of the skill to generate (10-2000 chars)' },
+                auto_publish: {
+                    type: 'boolean',
+                    description: 'If true, automatically publish the generated skill (default: false — returns draft for review)',
+                },
+            },
+            required: ['prompt'],
+        },
+        handler: async (args, client) => {
+            const prompt = z.string().min(10).max(2000).parse(args.prompt);
+            const autoPublish = args.auto_publish ? z.boolean().parse(args.auto_publish) : false;
+            const generated = await client.generateSkill(prompt);
+            if (!autoPublish) {
+                return { draft: true, ...generated };
+            }
+            const published = await client.publishSkill({
+                title: generated.title,
+                content: generated.content,
+                description: generated.description,
+                tags: generated.tags,
+                invocation_type: generated.invocation_type,
+                status: 'active',
+            });
+            return { draft: false, ...generated, published };
+        },
+    },
+    {
+        name: 'compose_skills',
+        description: 'Compose multiple skills into a CLAUDE.md + agent_docs structure. Works without auth for public skills. Requires SKILLSLAP_TOKEN to include your own draft skills.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                skill_ids: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of skill UUIDs to compose together',
+                },
+                project_name: {
+                    type: 'string',
+                    description: 'Optional project name for the composed output',
+                },
+            },
+            required: ['skill_ids'],
+        },
+        handler: async (args, client) => {
+            const skillIds = z.array(z.string().uuid()).min(1).parse(args.skill_ids);
+            const projectName = args.project_name ? z.string().parse(args.project_name) : undefined;
+            const result = await client.composeSkills(skillIds, projectName);
+            return formatComposeResult(result, skillIds);
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "skillslap-mcp",
+  "version": "1.2.0",
+  "description": "SkillSlap MCP server for agent skill marketplace integration",
+  "type": "module",
+  "bin": {
+    "skillslap-mcp": "dist/index.js",
+    "skillslap": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js dist/cli.js",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/atapifire/skillslap.git",
+    "directory": "skillslap/mcp-server"
+  },
+  "homepage": "https://github.com/atapifire/skillslap/tree/main/skillslap/mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/atapifire/skillslap/issues"
+  },
+  "author": "atapifire",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "skillslap",
+    "agent",
+    "skills",
+    "marketplace"
+  ],
+  "license": "MIT"
+}