Using skills

A skill is a packaged procedure an agent can discover and invoke. Skills are configured on agent and saga types; they do not apply to one-shot.

Referencing a skill#

A skill is referenced by string, in one of three forms:

import { createAgent } from '@coresourceai/sdk';

const researcher = createAgent({
  type: 'saga',
  systemPrompt: 'Prefer primary sources and retain direct URLs.',
  skills: [
    // An installed skill name.
    'deep-research',

    // A public owner/repository/path reference.
    'anthropics/skills/skills/pdf',

    // A full GitHub tree URL, pinned to a commit.
    'https://github.com/owner/repository/tree/COMMIT_SHA/path/to/skill'
  ],
  outputs: ['research.md']
});

await researcher.close();

Pin the URL form to a commit SHA rather than a branch. A skill that changes under you changes your agent's behaviour with no corresponding change in your code.

Adding skills automatically extends the derived tool allowlist with list_skills and invoke_skill, so the agent can discover and call what you gave it.