# @agentforge/skills

> Composable skill system for building modular TypeScript AI agents: author skills, register capabilities, and compose behaviors.

Latest version **0.18.12** (published 2026-10-08) · MIT license · 0 weekly downloads

## Install

```sh
npm install @agentforge/skills
pnpm add @agentforge/skills
yarn add @agentforge/skills
bun add @agentforge/skills
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.18.12 |
| Published | 2026-10-08 |
| First published | 2026-02-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 276.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | Tom Van Schoor |
| Maintainers | tomvanschoor |
| Keywords | agent-skills, llm-skills, skills-system, skill-authoring, skill-registry, reusable-skills, agent-capabilities, agent-composition, composable-agents, modular-agents, typescript |

## Links

- npm: https://www.npmjs.com/package/@agentforge/skills
- Repository: https://github.com/TVScoundrel/agentforge
- Homepage: https://tvscoundrel.github.io/agentforge/
- Issues: https://github.com/TVScoundrel/agentforge/issues
- npm.io page: https://npm.io/package/@agentforge/skills

## Dependencies (3)

- [zod](https://npm.io/package/zod.md) ^3.24.1
- [gray-matter](https://npm.io/package/gray-matter.md) ^4.0.3
- [@agentforge/core](https://npm.io/package/@agentforge/core.md) 0.18.12

## Alternatives

- [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads
- [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads
- [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads
- [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads
- [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads

## Recent versions

- 0.18.12 (latest) — 2026-10-08
- 0.18.11 — 2026-10-07
- 0.18.10 — 2026-09-30
- 0.18.9 — 2026-09-29
- 0.18.8 — 2026-09-28
- 0.18.7 — 2026-09-24
- 0.18.6 — 2026-09-23
- 0.18.5 — 2026-09-20
- 0.18.4 — 2026-09-18
- 0.18.3 — 2026-09-16
- 0.18.2 — 2026-09-15
- 0.18.1 — 2026-09-14
- 0.18.0 — 2026-09-12
- 0.17.2 — 2026-09-08
- 0.17.1 — 2026-09-07
- … 109 more at https://npm.io/package/@agentforge/skills/versions

## README

# @agentforge/skills

> Composable skill system for building modular AI agents in TypeScript, part of the AgentForge framework.

[![npm version](https://img.shields.io/npm/v/@agentforge/skills)](https://www.npmjs.com/package/@agentforge/skills)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue)](https://www.typescriptlang.org/)
[![License](https://img.shields.io/badge/license-MIT-green)](../../LICENSE)

## Installation

```bash
npm install @agentforge/skills
# or
pnpm add @agentforge/skills
# or
yarn add @agentforge/skills
```

> **Note:** Requires `@agentforge/core` as a peer dependency.

## Overview

`@agentforge/skills` provides Agent Skill discovery, registration, access, and trust policy enforcement for AgentForge agents. Within Agent Skill access, Skill activation loads trusted instructions while resource access loads supporting files. It implements the [Agent Skills Specification](https://agentskills.io) for composable, modular agent capabilities.

Full source code and API will be available after ST-07002 (Move Skills Source Files). See the [AgentForge docs](https://tvscoundrel.github.io/agentforge/) for usage guides and tutorials.

## Agent Skill Access

Access Agent Skill instructions and supporting resources through the Tools bound
to a `SkillRegistry`:

```typescript
import { SkillRegistry } from '@agentforge/skills';

const registry = new SkillRegistry({
  enabled: true,
  skillRoots: [{ path: '.agentskills', trust: 'workspace' }],
});

const [activateSkill, readSkillResource] = registry.toActivationTools();
```

`resolveResourcePath` remains exported for compatibility, but it is deprecated
and planned for removal in the next major release. Use the
`read-skill-resource` Tool for Agent Skill resource access instead.

## License

MIT — see [LICENSE](../../LICENSE) for details.

---
_Source: https://npm.io/package/@agentforge/skills · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._