internal/

Package agent defines the pluggable per-agent behavior gskill installs into, plus a registry of adapters.

Package app is gskill's orchestration layer.

Package cache is the content-addressed cache of fetched source material, enabling offline reproduction from a warm cache.

Package cli is the gskill command-line view.

Package config resolves gskill's layered configuration.

Package discovery locates SKILL.md bundles within fetched material and enforces naming and frontmatter schema rules.

Package docs generates GSKILL's reference documentation from the live sources of truth — the Kong command grammar (internal/cli) and the exit-code table (internal/errs) — so the reference can never silently drift from the tool.

Package errs defines gskill's typed errors and their mapping to process exit codes.

Package fsutil provides the filesystem primitives gskill relies on for safe, reproducible mutations: atomic file writes, same-filesystem staging temp dirs, and a symlink-or-copy activation that records the method actually used.

Package git defines the GitRunner interface and a system-git implementation that shells out to the installed git binary.

Package installer runs the staging-verify-activate install transaction with temp-then-rename atomicity under an exclusive lock.

Package integrity provides canonical content hashing, fail-closed verification, and drift classification for installed skills.

Package lockfile loads and saves the gskill.lock file as deterministic, sorted-key JSON capturing resolved install reality.

Package logging configures gskill's structured logger.

Package manifest loads, validates, and saves the gskill.toml manifest that records install intent.

Package metadata models and parses SKILL.md YAML frontmatter, including the declared requires block.

Package resolver turns a requested source reference into a resolved, immutable revision, keeping requested, resolved, and immutable refs distinct.

Package source parses, normalizes, and classifies skill source references (git shorthand, full HTTPS/SSH, local path, url) into a canonical identity.

Package store is the content-addressed store of installed skill content, keyed by canonical content hash.

Package testutil provides golden-file and temporary-directory helpers shared across gskill tests.

Package tui hosts the Bubble Tea dashboard and SKILL.md preview, rendering over the app service layer and refusing to launch without a TTY.

Package version exposes the gskill build version and source commit.