@dzhechkov/core

Foundation package of the DZ cross-platform harness. It owns the platform-neutral contracts that every other @dzhechkov/* package depends on.

What it provides

| Module | Exports | Purpose | |---|---|---| | skill.schema | CanonicalSkillFrontmatter, ClaudeSkillFrontmatter | Two-layer Zod schema for SKILL.md frontmatter | | hooks.schema | HookSchema | Shape of lifecycle hooks | | adapter | Adapter, Platform, EmitResult, … | The contract every @dzhechkov/adapter-* implements |

Two-layer skill schema

The Agent Skills open standard defines six frontmatter fields (name, description required; license, compatibility, metadata, allowed-tools optional). Claude Code consumes that standard and adds its own optional fields, and this repo's 90 skills additionally carry ~26 project-local keys.

So the schema has two layers:

• CanonicalSkillFrontmatter — strict agentskills.io standard. Used by the portable/canonical layer and by non-Claude adapters.
• ClaudeSkillFrontmatter — the canonical schema relaxed, plus Claude Code extensions, plus passthrough of unknown keys, so every existing SKILL.md validates without edits.

See features/extended-a-migration/agentskills-spec-verification.md for the verified spec this schema is built against.

Status

0.1.0 — alpha, part of the extended-a-migration feature (Phase 1). Additive only: this package never modifies existing skills or harness files.

Scripts

pnpm --filter @dzhechkov/core build      # tsc -> dist/
pnpm --filter @dzhechkov/core test       # vitest run
pnpm --filter @dzhechkov/core typecheck  # tsc --noEmit