agentic-plugins

A learning and experimentation playground for plugins and skills targeting agentic AI assistants (Claude, Auggie, etc.), structured to be dropped into a project and picked up automatically by the agent.

Structure

Each plugin lives in its own directory and follows a simple convention:

<plugin>/
  bin/script.sh       # main executable, receives env vars from the agent
  commands/<cmd>.md   # slash-command definitions (one file per command)
  skills/<skill>/     # optional reusable skills
    SKILL.md          # skill metadata and execution instructions
    scripts/          # scripts invoked by the skill

Plugins

aplugin

A general-purpose plugin with the following commands and skills:

commands:

• run — executes script.sh aplugin run and surfaces the output
• ver — reports the plugin version
• inspect-md — inspects a markdown file (word count, line count, headers, links)

skills:

• md-info — get stats about a markdown file
• txt-info — get stats about a plain text file (word count, line count, character count, top words)
• pdf-processor — extract text and metadata from a PDF
• uspecs — run uspecs commands (uchange, archive) for structured change management

cplugin

A minimal companion plugin with run and ver commands.

Version bumping

bump.sh generates a date-based version (MMDD.H.M), updates all version strings in tracked files, and commits + pushes.

bash bump.sh

Install and update

Claude Code

Register the marketplace and install plugins:

claude plugin marketplace add maximge-labs/agentic-plugins
claude plugin install cplugin@cmarket
claude plugin install aplugin@cmarket

After a new version is published, pull the update:

claude plugin marketplace update cmarket
claude plugin update cplugin@cmarket
claude plugin update aplugin@cmarket

Auggie CLI

auggie plugin marketplace add maximge-labs/agentic-plugins
auggie plugin install aplugin@amarket
auggie plugin install cplugin@amarket

Update:

auggie plugin marketplace update amarket
auggie plugin update aplugin@amarket
auggie plugin update cplugin@amarket

Notes

• Claude does not auto-update marketplace cache -- it stays frozen until you explicitly run the update commands above
• New colleague clones the repo -> Claude auto-installs (no action needed); version bump -> manual update required
• Default install scope is user (global, all projects); use --scope project for repo-level (.claude/settings.json) or --scope local for machine-local (.claude/settings.local.json, gitignored)

Links

Skills

• agentskills.io — open standard for agent skills (SKILL.md)
• Using scripts in skills
• Plugin examples with scripts

Claude Code docs

• Create plugins — skills, agents, hooks, MCP servers
• Plugins reference — full schema and CLI reference
• How to create custom skills
• Complete guide to building skills for Claude
• Permissions

Auggie CLI docs

• Plugins and marketplaces

Environment variables

The agent injects the following variables into plugin scripts at runtime:

• CLAUDE_PROJECT_DIR — root of the current project
• CLAUDE_PLUGIN_ROOT — root of the plugin directory
• CLAUDE_PLUGIN_DATA — plugin-specific data directory