@agentskit/templates

Create, validate, and scaffold custom AgentsKit extensions — tools, skills, and adapters — ready to publish and share.

Why

• Skip the boilerplate — scaffold() generates a complete npm package with src, tests, tsconfig, and README in one call
• Catch mistakes early — createToolTemplate() validates required fields and gives clear error messages before your code runs
• Extend, don't rewrite — inherit from built-in skills/tools and override only what you need

Install

npm install @agentskit/templates
Copy

Create a custom tool

import { createToolTemplate } from '@agentskit/templates'

const slackTool = createToolTemplate({
  name: 'slack-notify',
  description: 'Send a message to a Slack channel',
  schema: {
    type: 'object',
    properties: {
      channel: { type: 'string' },
      message: { type: 'string' },
    },
    required: ['channel', 'message'],
  },
  execute: async (args) => {
    await fetch(webhookUrl, { method: 'POST', body: JSON.stringify({ channel: args.channel, text: args.message }) })
    return `Sent to #${args.channel}`
  },
})
Copy

Extend a built-in skill

import { createSkillTemplate } from '@agentskit/templates'
import { researcher } from '@agentskit/skills'

const myResearcher = createSkillTemplate({
  base: researcher,
  name: 'my-researcher',
  systemPrompt: researcher.systemPrompt + '\nAlways cite sources with URLs.',
  temperature: 0.3,
})
Copy

Scaffold a full package

import { scaffold } from '@agentskit/templates'

await scaffold({
  type: 'tool',       // 'tool' | 'skill' | 'adapter'
  name: 'my-search',
  dir: './packages',
  description: 'Custom search tool for AgentsKit',
})
// → packages/my-search/
//     package.json, tsconfig.json, tsup.config.ts
//     src/index.ts (template with ToolDefinition)
//     tests/index.test.ts (contract test)
//     README.md
Copy

Next steps

• Publish your package to npm and depend on it from @agentskit/runtime or useChat like any other tool or skill
• Validate contracts against @agentskit/core types early — templates align with those definitions

Ecosystem

Docs

Full documentation