const { installed, result } = await trigger("skillkit::install", {
  id: "code-review-pro",
  agent: "code-agent"  // Optional: install for specific agent
});

if (installed) {
  console.log("Skill installed:", result);
} else {
  console.error("Installation failed:", result.error);
}

const { skills } = await trigger("skillkit::list", {});

console.log(`${skills.length} skills installed:`);
for (const skill of skills) {
  console.log(`- ${skill.name} (v${skill.version})`);
}

const { recommendations } = await trigger("skillkit::recommend", {
  context: "I need to analyze customer feedback from CSV files and generate sentiment reports"
});

console.log("Recommended skills:");
for (const skill of recommendations) {
  console.log(`- ${skill.name}: ${skill.description}`);
  console.log(`  Relevance: ${skill.relevanceScore}/10`);
}

const { found, count, root } = await trigger("skillkit::scan", {
  path: "./projects"  // Optional: defaults to workspace root
});

console.log(`Found ${count} skills in ${root}:`);
for (const item of found) {
  if (item.type === "skill") {
    console.log(`- SKILL.md: ${item.path}`);
    console.log(item.content?.slice(0, 200));
  } else if (item.type === "well-known") {
    console.log(`- .well-known file: ${item.path}`);
  }
}

# Code Review Pro

Advanced code review with security scanning and performance analysis.

## Inputs

- `code` (string, required): Source code to review
- `language` (string, optional): Programming language
- `checks` (array, optional): Specific checks to run

## Outputs

- `issues` (array): List of found issues
- `score` (number): Overall code quality score (0-100)
- `recommendations` (array): Improvement suggestions

## Example

```typescript
const result = await runSkill("code-review-pro", {
  code: "function add(a, b) { return a + b; }",
  language: "javascript",
  checks: ["security", "performance", "style"]
});

## Real-World Example: Content Pipeline

```typescript
// 1. Search for skills
const contentSkills = await trigger("skillkit::search", {
  query: "content generation writing seo",
  limit: 20
});

// 2. Install the best-rated skills
const toInstall = contentSkills.results
  .filter(s => s.rating >= 4.5 && s.downloads > 1000)
  .slice(0, 5);

for (const skill of toInstall) {
  const { installed } = await trigger("skillkit::install", {
    id: skill.id,
    agent: "content-creator"
  });
  
  if (installed) {
    console.log(`✓ Installed ${skill.name}`);
  }
}

// 3. List installed skills
const { skills } = await trigger("skillkit::list", {});
console.log(`Content pipeline has ${skills.length} skills`);

// 4. Get recommendations for optimization
const { recommendations } = await trigger("skillkit::recommend", {
  context: "Optimize blog posts for SEO and readability"
});

console.log("Suggested additions:");
for (const rec of recommendations.slice(0, 3)) {
  console.log(`- ${rec.name}`);
}

agentos skill list                  # List installed skills
agentos skill install <path>        # Install skill from path or marketplace
agentos skill remove <id>           # Remove installed skill
agentos skill search <query>        # Search marketplace
agentos skill create <name>         # Scaffold new skill

# Search marketplace
curl "http://localhost:3111/api/skillkit/search?query=data+analysis&limit=10"

# Install skill
curl -X POST http://localhost:3111/api/skillkit/install \
  -H "Content-Type: application/json" \
  -d '{
    "id": "csv-parser-pro",
    "agent": "data-analyst"
  }'

# List installed
curl http://localhost:3111/api/skillkit/list

# Get recommendations
curl "http://localhost:3111/api/skillkit/recommend?context=analyze+customer+sentiment"

# Scan workspace
curl "http://localhost:3111/api/skillkit/scan?path=./projects"

async function runSkillkit(
  args: string[],
  timeoutMs = 30_000
): Promise<{ stdout: string; stderr: string; exitCode: number }> {
  try {
    const { stdout, stderr } = await execFileAsync(
      "npx",
      ["skillkit", ...args],
      {
        timeout: timeoutMs,
        maxBuffer: 1024 * 1024,  // 1MB stdout
        env: SAFE_ENV,           // Stripped environment
        cwd: WORKSPACE_ROOT
      }
    );
    return { stdout, stderr, exitCode: 0 };
  } catch (err: any) {
    return {
      stdout: (err.stdout || "").slice(0, 100_000),
      stderr: (err.stderr || err.message || "").slice(0, 50_000),
      exitCode: err.code || 1
    };
  }
}

agentos skill create my-custom-skill