# @warabi1062/skillsmith

> Claude Code のスキル設計パターンをスキーマとして形式化し、プラグインを生成するツール

Latest version **1.1.0** (published 2026-09-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install @warabi1062/skillsmith
pnpm add @warabi1062/skillsmith
yarn add @warabi1062/skillsmith
bun add @warabi1062/skillsmith
```

Provides the command `skillsmith`.

## Health

**Score 60/100 (C)** — status: active.

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

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 1.1.0 |
| Published | 2026-09-24 |
| First published | 2026-04-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Dependencies | 1 |
| Unpacked size | 43.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | warabi1062 |
| Maintainers | warabi1062 |
| Keywords | claude, claude-code, skill, plugin, cli, generator |

## Links

- npm: https://www.npmjs.com/package/@warabi1062/skillsmith
- Repository: https://github.com/warabi1062/SkillSmith
- Homepage: https://github.com/warabi1062/SkillSmith#readme
- Issues: https://github.com/warabi1062/SkillSmith/issues
- npm.io page: https://npm.io/package/@warabi1062/skillsmith

## Dependencies (1)

- [@warabi1062/skillsmith-core](https://npm.io/package/@warabi1062/skillsmith-core.md) ^1.1.0

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 1.1.0 (latest) — 2026-09-24
- 1.0.4 — 2026-05-05
- 1.0.3 — 2026-04-29
- 1.0.2 — 2026-04-29
- 1.0.1 — 2026-04-26
- 1.0.0 — 2026-04-26
- 0.2.3 — 2026-04-22
- 0.2.2 — 2026-04-19
- 0.2.1 — 2026-04-19
- 0.2.0 — 2026-04-19
- 0.1.1 — 2026-04-19

## README

# @warabi1062/skillsmith

CLI for [SkillSmith](https://github.com/warabi1062/SkillSmith) — a tool that formalizes Claude Code skill design patterns as a schema and generates plugins that follow the Orchestrator + Worker skill + Agent pattern.

Write your skill definitions in TypeScript, then export them as Claude Code plugin files (`SKILL.md`, `agent.md`, and supporting assets).

## Install

```bash
pnpm add -D @warabi1062/skillsmith
```

To also launch the local Web viewer, add the optional peer:

```bash
pnpm add -D @warabi1062/skillsmith-viewer
```

## Commands

### Export a single plugin

```bash
skillsmith plugin export <plugin.ts> --output <dir>
```

Loads a TypeScript `plugin.ts` file that `default export`s a `PluginDefinition` and writes the generated Markdown files to the target directory.

### Export an entire marketplace

```bash
skillsmith marketplace export <marketplace-dir> --output <dir>
```

Walks `marketplace-dir/plugins/*/plugin.ts` and exports every plugin in one run.

### Launch the local Web viewer

```bash
skillsmith web [marketplaces-dir]
```

Starts a local SPA + thin HTTP API server that visualizes plugin definitions and orchestrator structure in the browser. When `marketplaces-dir` is omitted, `skillsmith web` falls back to `./marketplaces` in the current working directory. Requires `@warabi1062/skillsmith-viewer` to be installed; if it's missing, the command prints install instructions and exits.

## Writing a plugin

Each plugin lives in `marketplaces/{marketplace}/plugins/{name}/plugin.ts` and default-exports a `PluginDefinition`. Skills are instances of one of four classes (`EntryPointSkill`, `WorkerSkill`, `WorkerWithSubAgent`, `WorkerWithAgentTeam`) composed from `steps[]`, `sections[]`, and tool references (`tool()`, `bash()`, `mcp()`).

See the [plugin authoring reference](https://github.com/warabi1062/SkillSmith/blob/main/docs/reference.md) for the full schema, design patterns, and anti-patterns.

## License

MIT © warabi1062

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