const skill = await client.query(api.skills.get, {
  name: "typescript-strict-mode"
});

{
  _id: Id<"skills">,
  name: string,
  version: string,
  category: string,
  description: string,
  prompt: string,
  platforms: string[],
  use_cases: string[],
  tags: string[],
  confidence: number,
  execution_count: number,
  success_rate: number,
  agent_count: number,
  author: string,
  created_at: number,
  updated_at: number
}

const results = await client.query(api.skills.search, {
  query: "typescript configuration",
  category: "coding",
  minConfidence: 0.8,
  platforms: ["claude-code"],
  limit: 10
});

{
  skills: Skill[],
  total: number,
  hasMore: boolean
}

const skills = await client.query(api.skills.list, {
  category: "coding",
  sortBy: "confidence",
  limit: 20
});

const skills = await client.query(api.skills.listAdvanced, {
  categories: ["coding", "workflow"],
  platforms: ["claude-code", "cursor"],
  minConfidence: 0.75,
  hasActiveSession: true,
  sortBy: "trending",
  limit: 20
});

const categories = await client.query(api.skills.getCategories);

[
  { name: "coding", count: 15234 },
  { name: "workflow", count: 4567 },
  { name: "security", count: 2341 }
]

const lineage = await client.query(api.skills.getLineage, {
  name: "typescript-strict-mode"
});

{
  skill: Skill,
  parent: Skill | null,
  children: Skill[],
  evolutions: Evolution[],
  totalDescendants: number
}

const trending = await client.query(api.skills.trendingEvolutions, {
  period: "week",
  limit: 10
});

const active = await client.query(api.skills.withActiveSessions, {
  limit: 10
});

const skillId = await client.mutation(api.skills.create, {
  name: "my-new-skill",
  version: "0.1.0",
  category: "coding",
  description: "My custom skill",
  prompt: "Skill instructions...",
  platforms: ["claude-code", "cursor"],
  use_cases: ["Use case 1", "Use case 2"],
  tags: ["typescript", "config"]
});

await client.mutation(api.skills.update, {
  name: "my-skill",
  version: "0.2.0",
  prompt: "Updated instructions..."
});

const forkId = await client.mutation(api.skills.fork, {
  sourceName: "typescript-strict-mode",
  newName: "my-typescript-config",
  changes: {
    description: "My customized version"
  }
});

await client.mutation(api.skills.delete, {
  name: "my-skill"
});

client.subscribe(api.skills.get, { name: "typescript-strict-mode" }, (skill) => {
  console.log("Skill updated:", skill);
  console.log("New confidence:", skill.confidence);
});

client.subscribe(
  api.skills.search,
  { query: "typescript", limit: 5 },
  (results) => {
    console.log("Results updated:", results.skills.length);
  }
);

// Search with multiple filters
const results = await client.query(api.skills.search, {
  query: "react hooks",
  category: "coding",
  platforms: ["claude-code"],
  minConfidence: 0.85,
  limit: 5
});

console.log(`Found ${results.total} skills`);
for (const skill of results.skills) {
  console.log(`${skill.name} - ${skill.confidence}%`);
}

const skill = await client.query(api.skills.get, {
  name: "typescript-strict-mode"
});

console.log(`
Skill: ${skill.name} v${skill.version}
Confidence: ${skill.confidence}%
Executions: ${skill.execution_count}
Success Rate: ${skill.success_rate}%

Prompt:
${skill.prompt}
`);

// Fork a skill
const forkId = await client.mutation(api.skills.fork, {
  sourceName: "typescript-strict-mode",
  newName: "typescript-strict-monorepo",
  changes: {
    description: "Strict TypeScript for monorepos",
    tags: [...originalTags, "monorepo", "turborepo"]
  }
});

// Update the fork
await client.mutation(api.skills.update, {
  name: "typescript-strict-monorepo",
  prompt: customizedPrompt
});