@werk/aktenwerk (0.1.0)

Published 2026-07-26 20:10:49 +02:00 by amelie

Set up this registry in your project .npmrc file:

@werk:registry=https://gitlab.amandy.love/api/packages/werk/npm/

To install the package using npm, run the following command:

npm install @werk/aktenwerk@0.1.0

or add it to the package.json file:

"@werk/aktenwerk": "0.1.0"

For more information on the npm registry, see the documentation.

Monorepo for Akte, Aktenordner, and Agentwerk

Aktenwerk

Aktenwerk is a small TypeScript monorepo for describing, storing, and activating local capabilities.

The system has three layers:

Akte: a TOML manifest format for describing a capability, document, skill, command, or service.
Aktenordner: a local registry that scans .werk/, copies declared files into a store, indexes versions, and runs diagnostics.
Agentwerk: an agent-skill manager that activates registered agent.skill Akten into a global agent-facing skills directory.

The short version: Akte describes, Aktenordner collects, Agentwerk activates.

Packages

@akte/core: manifest types, TOML parsing, validation, and normalization.
@akte/aktenordner-core: local registry, project scanning, add/remove, requirement checks, and store doctor.
aktenordner-cli: CLI for scanning, registering, listing, searching, and diagnosing Akten.
@akte/agentwerk-core: Agentwerk skill validation, activation, deactivation, sync, and doctor.
agentwerk-cli: CLI for registering and activating agent skills.

Store And Agent Locations

By default, Aktenordner writes to:

~/.local/share/werk

By default, Agentwerk activates skills into Agent Skills packages:

~/.agents/skills/<skill-slug>/SKILL.md

The default target is always all, which writes one skill package directly under ~/.agents/skills. Codex uses its own native skill directory, so --target codex writes to ${CODEX_HOME:-~/.codex}/skills/<skill-slug>/SKILL.md. Other explicit targets write under ~/.agents/skills/<target>/<skill-slug>/SKILL.md.

For testing or dogfooding, use isolated locations:

export WERK_STORE_DIR=/tmp/aktenwerk-store
export AGENTS_HOME=/tmp/aktenwerk-agents
export CODEX_HOME=/tmp/aktenwerk-codex

Common Workflow

Scan the current project for Akten:

bun packages/aktenordner-cli/dist/index.js scan .

bun packages/aktenordner-cli/dist/index.js add .

List registered Akten:

bun packages/aktenordner-cli/dist/index.js list

Activate a registered Agentwerk skill:

bun packages/agentwerk-cli/dist/index.js activate agent.skill.agentwerk-skill-writer

Check state:

bun packages/aktenordner-cli/dist/index.js doctor
bun packages/agentwerk-cli/dist/index.js doctor

Refresh active skill files:

bun packages/agentwerk-cli/dist/index.js sync

Deactivate and remove:

bun packages/agentwerk-cli/dist/index.js deactivate agent.skill.agentwerk-skill-writer --target all
bun packages/aktenordner-cli/dist/index.js remove agent.skill.agentwerk-skill-writer

Creating Agent Skills

Agent skills live under:

.werk/
  skills/
    <skill-slug>/
      akte.toml
      SKILL.md
      references/     # optional
      scripts/        # optional
      assets/         # optional

The manifest must be a valid Akte and a valid Agentwerk skill:

schema = "akte/v1"

id = "agent.skill.example"
kind = "agent.skill"
name = "Example Skill"
description = "A concise sentence describing what this skill helps an agent do."
version = "0.1.0"

[owner]
project = "example-project"

[[files]]
role = "skill"
path = "SKILL.md"

[data.agentwerk]
entry = "SKILL.md"
target = "all"
activation = "symlink"

Agentwerk enforces the skill-specific contract at activation time and in agentwerk add:

kind must be agent.skill.
id must start with agent.skill..
version must be SemVer-like, for example 0.1.0.
[data.agentwerk] must exist.
data.agentwerk.entry must be SKILL.md and point to a file listed in [[files]].
[[files]] must include an item with role = "skill".
data.agentwerk.target, when present, declares the intended target compatibility and must be a simple target name. Activation without --target still uses all.
data.agentwerk.activation, when present, must be symlink or copy.
SKILL.md must start with YAML frontmatter containing name and description.

Development

Build all TypeScript project references:

bun run build

Run the lifecycle test suite:

bun run test

The tests use temporary WERK_STORE_DIR and AGENTS_HOME values and do not touch the real user store.

Dependencies

ID	Version
@akte/agentwerk-core	^0.1.0
@akte/aktenordner-core	^0.1.0
@akte/core	^0.1.0

Development Dependencies

ID	Version
@types/node	^20.12.7
typescript	^5.4.5

Details

npm

2026-07-26 20:10:49 +02:00

latest

30 KiB

Assets (1)

aktenwerk-0.1.0.tgz 30 KiB

Versions (1) View all

0.1.0

2026-07-26