plugin-builder
Use when hardening, converting, auditing, or pre-release checking a Codex plugin package by verifying manifest paths, bundled skills, hooks, MCP/app config, validation gates, and release blockers.
75
92%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong description that clearly defines a specific niche (Codex plugin package verification and release readiness). It effectively communicates both what the skill does and when to use it, with rich domain-specific trigger terms. The description is concise yet comprehensive, making it easy for Claude to select this skill appropriately from a large pool.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: hardening, converting, auditing, pre-release checking, verifying manifest paths, bundled skills, hooks, MCP/app config, validation gates, and release blockers. These are detailed and concrete. | 3 / 3 |
Completeness | Clearly answers both 'what' (verifying manifest paths, bundled skills, hooks, MCP/app config, validation gates, release blockers) and 'when' (explicitly starts with 'Use when hardening, converting, auditing, or pre-release checking a Codex plugin package'). | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms a user would say: 'hardening', 'converting', 'auditing', 'pre-release checking', 'Codex plugin', 'manifest', 'hooks', 'MCP', 'validation gates', 'release blockers'. Good coverage of domain-specific terms users working with Codex plugins would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — targets a very specific niche of Codex plugin package verification and release readiness. The combination of 'Codex plugin', 'manifest paths', 'bundled skills', 'hooks', 'MCP/app config', and 'release blockers' creates a clear, unique identity unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill with strong actionability and workflow clarity. It provides concrete commands, clear validation checkpoints with feedback loops, and good progressive disclosure to reference files. The main weakness is moderate verbosity in execution boundaries and constraints sections, with some overlapping guidance that could be consolidated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient and avoids explaining basic concepts, but some sections like 'Execution Boundaries' and 'Constraints' contain overlapping guidance that could be tightened. The context-disposition policy paragraph feels like internal process language rather than actionable instruction. | 2 / 3 |
Actionability | Provides concrete, executable bash and jq commands, specific file paths to inspect, a clear before/after JSON example for manifest fixes, and a structured YAML output schema. The guidance is copy-paste ready and specific. | 3 / 3 |
Workflow Clarity | The 5-step workflow is clearly sequenced with explicit validation checkpoints (step 3: validate before changes, step 5: rerun gate and return evidence). There's a clear feedback loop (validate → patch → revalidate) and a fail-fast policy. The failure mode section adds explicit stop conditions. | 3 / 3 |
Progressive Disclosure | The SKILL.md provides a compact overview with well-signaled one-level-deep references to workflow.md, current-codex-plugin-runtime.md, and other reference files. Each reference includes a clear 'Read when' condition explaining when to consult it. Content is appropriately split between the overview and detailed references. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- jscraik/Agent-Skills
- Commit
4c78f98
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.