AI Coding Agent Skills
Relevant source files
The following files were used as context for generating this wiki page:
AI Coding Agent Skills are a collection of specialized prompts and instruction sets designed to enable AI agents—such as Claude Code, Codex, and Gemini—to automate complex release management tasks using the pubm ecosystem. These skills bridge the gap between human developers and the CLI, providing the agent with the necessary context to analyze project structures, configure registries, and manage plugin lifecycles.
The skills are distributed as a bundle within the plugins/pubm-plugin/skills/ directory and can be installed either through the pubm setup-skills command or as part of the pubm init wizard. They are intended to orchestrate existing pubm commands rather than replacing them, ensuring that the AI agent follows the project's guarded release workflows.
Sources: CLAUDE.md:46-52, plugins/pubm-plugin/INSTALLATION.md:28-34, website/public/INFORMATION.md:31-33
Skill Architecture and Installation
The system supports multiple AI platforms by installing skill files into specific hidden directories within a user's project. The pubm CLI handles the fetching of these skills directly from the GitHub repository to ensure agents always use the latest logic.
Supported Agents and Paths
| Agent | Label | Local Installation Path |
|---|---|---|
claude-code | Claude Code | .claude/skills/pubm |
codex | Codex CLI | .agents/skills/pubm |
gemini | Gemini CLI | .gemini/skills/pubm |
Sources: packages/pubm/src/commands/setup-skills.ts:18-28
The Installation Flow
When a user runs pubm setup-skills, the CLI interacts with the GitHub API to resolve the latest release tag and download the recursive file tree of the plugins/pubm-plugin/skills directory.
Core Skill: Publish Setup
The publish-setup skill is the entry point for an AI agent to configure a project for pubm. It follows a multi-step analytical workflow to detect ecosystems and recommend configurations.
Analysis Workflow
- Project Mapping: The agent scans manifest files (
package.json,Cargo.toml,jsr.json) and workspace configurations to determine if the project is a monorepo or a single package. - Registry Detection: Based on the files found, it detects target registries (e.g.,
npm,jsr,crates). - Plugin Recommendation: It evaluates if official plugins like
externalVersionSyncorbrewTapare needed. - CI/CD Configuration: It suggests GitHub Actions templates based on the detected package manager.
Sources: plugins/pubm-plugin/skills/publish-setup/SKILL.md:18-54
CI/CD Integration Logic
If the user selects CI/CD setup, the agent generates appropriate secrets and workflow files:
- npm: Requires
NODE_AUTH_TOKEN - jsr: Requires
JSR_TOKEN - crates.io: Requires
CARGO_REGISTRY_TOKEN
Sources: plugins/pubm-plugin/skills/publish-setup/SKILL.md:162-178
Core Skill: Plugin Creation
The create-plugin skill allows AI agents to scaffold new functionality for pubm. This skill manages three distinct forms of plugin implementation.
Plugin Forms
| Form | implementation Detail | Use Case |
|---|---|---|
| Config Inline | Function added to pubm.config.ts | Simple one-off hooks |
| Single File | .ts factory function file | Lightweight reusable logic |
| Package | Full packages/plugins/plugin-{name} | Publishable, tested packages |
Sources: plugins/pubm-plugin/skills/create-plugin/SKILL.md:46-55
Hook Lifecycle
Agents use this skill to register logic against specific lifecycle events.
Skill Maintenance and Usage
The skill bundle is maintained as a checked-in asset in the pubm repository. This allows developers to update agent behavior by modifying the Markdown files in the skills/ directory.
- Skill Definition: Each skill is defined in a
SKILL.mdfile with specificallowed-tools(e.g., Bash, Read, Write, Edit). - Reference Context: Skills often rely on a
references/subdirectory containing config templates and registry-specific constraints. - Initialization: The
pubm initcommand includes a dedicated section for "Coding Agent Skills" which calls therunSetupSkillslogic to ensure the environment is agent-ready upon first setup.
Sources: packages/pubm/src/commands/init.ts:167-185, plugins/pubm-plugin/skills/publish-setup/SKILL.md:1-12, plugins/pubm-plugin/INSTALLATION.md:20-26
AI Coding Agent Skills provide a standardized way for automated systems to interact with the pubm publishing pipeline. By providing clear instruction sets for setup, plugin creation, and version management, these skills ensure that AI agents maintain the same safety and reliability standards as human operators using the CLI.