Skip to content
This repository was archived by the owner on Jul 30, 2026. It is now read-only.
This repository was archived by the owner on Jul 30, 2026. It is now read-only.

docs: lead with two-doors positioning (CLI · skill · plugin) #21

Description

@nabsha

The README/SKILL lead agent-first, which causes recurring "why install this as a skill / why not just a plugin?" confusion (it came up repeatedly).

Reframe the umbrella README + skill README to lead with the audiences:

  • CLI for you — a .env-replacement you run at your terminal (a human doesn't need the "skill" framing).
  • Skill for your agent, everywhere — the portable AgentSkills artifact (Claude Code, Agent SDK, claude.ai, OpenClaw).
  • Plugin for Claude Code — the enforced superset (guard hook + MCP + /kdbx:*) that bundles the skill.

Key facts to surface: plugins are Claude-Code-only, so the skill is the portable core; the agent's real value is run/check (use secrets without seeing them). Resolves the "why a skill" + "why not plugin-only" questions for the next reader.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions