skillview

A local-only web GUI for inspecting agent skills (SKILL.md format) across personal, project, plugin, cache, and marketplace sources.

= 20">

bunx @pc_style/skillview

Run it from the workspace you want to inspect. Skillview opens a browser and builds a provenance-aware inventory of the agent skills on your machine — the shared SKILL.md format used by Claude Code, Amp, Codex, and other coding agents. Discovery currently reads the ~/.claude configuration tree, including skills symlinked in from shared locations like ~/.agents/skills.

Also works with npx @pc_style/skillview if you don't use Bun.

highlights

• provenance-aware — the same skill can appear as an installed plugin copy, a cached version, and a marketplace source; each record keeps its source, plugin, marketplace, and version context
• fast filtering — search by name, description, or path; filter by source and lifecycle
• deep inspection — rendered Markdown, raw SKILL.md, file trees, and metadata for every skill
• safe by design — read-mostly, localhost-only, no cloud sync

sources

Skillview discovers:

Skillview deliberately does not scan ~/.agents/skills wholesale. A shared skill appears only when it is explicitly linked into ~/.claude/skills. Ephemeral runtime bundles under /private/tmp are also excluded from the standalone package.

options

--workspace <path>  workspace to scan instead of the current directory
--port <number>     localhost port, or 0 for an available port (default: 4173)
--no-open           start the server without opening a browser
-h, --help          show help

Examples:

bunx @pc_style/skillview --workspace ~/projects/my-app
bunx @pc_style/skillview --port 4317 --no-open

SKILL_VIEW_WORKSPACE_ROOT remains available as an environment override.

lifecycle labels

what it does

• previews skill descriptions, rendered Markdown, raw SKILL.md, metadata, and file trees
• searches and filters by source and lifecycle
• shows plugin, marketplace, version, linked-target, and canonical-path provenance
• copies paths and skill content
• reveals freshly validated skill folders in Finder on macOS
• enables or disables direct user/project skills by renaming SKILL.md to SKILL.md.disabled and back, after confirmation

safety

Skillview binds only to 127.0.0.1. Skill content stays on your machine and is never sent to a cloud service.

All actions use server-issued skill IDs. Before reveal or toggle, the server freshly rediscovers the record, validates its source and canonical path, and checks its capabilities. Raw client-provided filesystem paths are not accepted.

Plugin cache, marketplace, installed-plugin, and linked records are inspection-only. Their files are managed by Claude/plugin tooling and are never renamed by Skillview. Project and marketplace traversal is bounded and does not follow symlinks.

Deletion and arbitrary file editing are deliberately unavailable.

local development

Requires Node.js 20 or newer.

bun install
bun run dev

Build and run the same standalone server shipped in the package:

bun run build
bun start -- --no-open

checks

bun run test
bun run build
npm pack --dry-run

The suite covers frontmatter parsing, all six source kinds, linked-skill handling, plugin registry validation, provenance-preserving IDs, action authorization, static asset isolation, and the production HTTP boundary.

publishing

Publishing is intentionally manual:

npm pack --dry-run
npm publish --dry-run
npm publish

license

MIT