Library

drwn library manages local reusable inventory. Inventory is what the harness can see; defaults are the subset that should be active machine-wide.

List And Show Inventory

drwn library list
drwn library list skills
drwn library list mcp
drwn library list --json
drwn library show <id>
drwn library show <id> --json

The library contains repo-native skills, installed package-backed skills, built-in MCP servers, and user-registered MCP definitions.

Add A Skill Bundle

drwn library add skill <package-spec>
drwn library add skill <package-spec> --json

Examples:

drwn library add skill github:remyjkim/darwinian-harness-skills
drwn library add skill /path/to/darwinian-harness-skills

This makes the bundle available. It does not activate its skills in any project and does not make them defaults.

Add An MCP Definition

drwn library add mcp ./github-mcp.json --as github --dry-run --json
drwn library add mcp ./github-mcp.json --as github

Use --replace only when you intend to overwrite an existing user-library MCP entry.

Card Catalogs

Card catalogs are Git-backed discovery indexes used by drwn search card.

drwn library catalog list
drwn library catalog list --json
drwn library catalog add <url>
drwn library catalog refresh
drwn library catalog refresh --json
drwn library catalog refresh <scope>
drwn library catalog remove <scope-or-url>

library catalog add reads the catalog scope from the catalog manifest. The scope is not supplied as a separate CLI argument.

Defaults

Defaults make reusable inventory active machine-wide:

drwn library defaults list
drwn library defaults list --json
drwn library defaults add skill <skill-name> --dry-run --json
drwn library defaults add skill <skill-name>
drwn library defaults remove skill <skill-name> --dry-run --json
drwn library defaults remove skill <skill-name>
drwn library defaults add mcp <server-name> --dry-run --json
drwn library defaults add mcp <server-name>
drwn library defaults remove mcp <server-name> --dry-run --json
drwn library defaults remove mcp <server-name>

Adding a default skill also curates shared skills into ~/.agents/skills.

Common Flows

Make the Darwinian Harness workflow skills available:

drwn library add skill github:remyjkim/darwinian-harness-skills
drwn skills packages show darwinian-harness-skills

Use one skill in one project:

drwn add skill materialize-harness --dry-run --json
drwn add skill materialize-harness
drwn write --dry-run

Make one skill a machine default:

drwn library defaults add skill inspect-harness --dry-run --json
drwn library defaults add skill inspect-harness