Skill System

import { resolveSkill } from "@x/core/skills";

// By ID
const skill = resolveSkill("web-search");

// By path (many variants supported)
const skill = resolveSkill("skills/web-search/skill.ts");
const skill = resolveSkill("src/application/assistant/skills/web-search/skill.ts");

import { skillCatalog } from "@x/core/skills";

console.log(skillCatalog);

# Rowboat Skill Catalog

Use this catalog to see which specialized skills you can load.

## Create Presentations
- **Skill file:** `src/application/assistant/skills/create-presentations/skill.ts`
- **Use it for:** Create PDF presentations and slide decks from natural language requests

## Document Collaboration
- **Skill file:** `src/application/assistant/skills/doc-collab/skill.ts`
- **Use it for:** Collaborate on documents - create, edit, and refine notes

...

tools:
  loadSkill:
    type: builtin
    name: loadSkill

// Load skill by ID
await loadSkill({ identifier: "web-search" });

// Load skill by path
await loadSkill({ 
  identifier: "src/application/assistant/skills/web-search/skill.ts" 
});

type SkillDefinition = {
  id: string;              // Skill identifier
  title: string;           // Display name
  summary: string;         // Short description
  content: string;         // Full Markdown content
};

type ResolvedSkill = {
  id: string;              // Skill identifier
  catalogPath: string;     // Path in catalog
  content: string;         // Full Markdown content
};

const definitions: SkillDefinition[] = [
  {
    id: "web-search",
    title: "Web Search",
    summary: "Searching the web or researching topics",
    content: webSearchSkill
  },
  // ... more skills
];

// Register with multiple aliases
for (const entry of skillEntries) {
  const aliases = [
    entry.id,
    `${entry.id}/skill`,
    `${entry.id}/skill.ts`,
    `skills/${entry.id}/skill.ts`,
    `src/application/assistant/skills/${entry.id}/skill.ts`,
    absolutePath
  ];
  
  for (const alias of aliases) {
    registerAliasVariants(alias, resolvedEntry);
  }
}

export const skill = String.raw`
# My Skill

Description of what this skill provides.

## When to Use

Load this skill when...

## Available Tools

### tool-name
Description and usage...

## Workflows

Step-by-step procedures...

## Best Practices

Patterns and anti-patterns...

## Examples

Code snippets and configurations...
`;

export default skill;

import mySkill from "./my-skill/skill.js";

const definitions: SkillDefinition[] = [
  // ... existing skills
  {
    id: "my-skill",
    title: "My Skill",
    summary: "Short description of my skill",
    content: mySkill
  }
];

await loadSkill({ identifier: "my-skill" });