inspect-plugin
Skill1 starsChanged 34 days agoMITView on GitHub
Use for read-only inspection or per-skill quality assessment of a Claude Code or Codex plugin from source, an archive, or an accessible Plugin Creator release, including structure, workflow boundaries, compatibility, integrations, and release history.
In this repository27 other files it gives its agents.
- architectSkill
- audit-discoverySkill
- audit-initSkill
- audit-nextSkill
- audit-resolutionSkill
- audit-statusSkill
- audit-triageSkill
- audit-verificationSkill
- code-to-prdSkill
- codex-ubuntu-serverSkill
- copilot-review-customizerSkill
- create-pluginSkill
- debugSkill
- deep-reviewSkill
- design-promptsSkill
- diagnose-sessionSkill
- feature-scatteringSkill
- human-execution-runbookSkill
- humanizerSkill
- init-repo-instructionsSkill
- install-agent-pluginsSkill
- local-wikiSkill
- recoverSkill
- review-feedbackSkill
- review-repo-instructionsSkill
- uncompromising-handoverSkill
- update-pluginSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 1 is distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 36
Read relevant text in batches of at most 20 exact read_paths from that inventory.
- Very specific: line 40
Use get_owned_plugin_archive for binary, oversized, or unavailable content.
- Very specific: line 59
When asked to assess each skill (rather than merely inspect packaging), enumerate every actual skills/*/SKILL.md entry point from the …
- Very specific: line 61
Read each entire SKILL.md and the specific supporting references necessary to understand its operating contract.
- Very specific: line 78
Only query historical releases when the user asks about previous versions, release history, regression origin, or comparison.
- Distinctive: line 93
Prefer a compact summary: identity/version, selected hosts, skills, integrations, authoritative files, useful constraints, and concrete …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Inspect plugin
Inspect first, change nothing unless the user separately asks for an edit. Read the shared platform contracts for host-specific manifest authority and compatibility boundaries.
For installed-plugin discovery, enablement, stale cache or installation troubleshooting, use install-agent-plugins in read-only mode until the user authorizes a host change. This skill inspects package contents/releases; it does not silently refresh or reinstall the host copy.
Select the actual source
For an attached archive or local repository, inspect that exact source; no Plugin Creator connection is required. Read the complete inventory and relevant source, not only filenames. Do not replace a supplied snapshot with a live branch without request, and do not assume archive suffixes establish freshness. Resolve a repository URL through the available source connector when appropriate.
For a hosted plugin, discover the backend's available tools first. Installing this package does not connect them. Resolve the exact backend ID from returned metadata or supported discovery; a display name, GPT ID, URL slug, or local file ID is not a plugin ID. Preserve its spelling/case/prefix. Do not treat absence from one listing as proof the plugin does not exist or that edit access was denied.
Current source
- For metadata-only hosted questions, use
get_plugin_metadata. For file content, callget_plugin_filesfirst withoutread_paths, then follow everynext_offsetneeded for the requested inventory. Do not guess unread paths. - Read relevant text in batches of at most 20 exact
read_pathsfrom that inventory. The current reader reports missing text paths inmissing_pathsalongside readable content; inspect that field rather than assuming every requested file was returned. Refresh the inventory/release if it changed and correct the paths. Useget_owned_plugin_archivefor binary, oversized, or unavailable content. For full-plugin inspection, finish the inventory before describing all components; for focused work, state the inspected scope. Local sources follow the same completeness rule without a backend API or release guard. - Retain
current_release_id. If it changes between reads, refresh against a consistent release; do not combine different releases into a claimed snapshot. - Inspect the manifests actually present: portable root
plugin.json, native.codex-plugin/plugin.json, and/or.claude-plugin/plugin.json, plus skills, links/assets, and relevant MCP/hooks/apps. Check which format the target host selects; do not assume a native manifest is always a fallback or that settings merge. Report drift without editing. - Compare selected host capabilities, launch paths, dependency availability, and output/action boundaries. Two manifests do not prove identical runtime behavior.
- Distinguish confirmed source facts, inferred behavior from instructions, actual execution evidence, and unavailable checks. Do not invent a defect from a generic pattern or claim live loading from a valid archive.
Skill quality assessment
When asked to assess each skill (rather than merely inspect packaging), enumerate
every actual skills/*/SKILL.md entry point from the complete source inventory.
Read each entire SKILL.md and the specific supporting references necessary to
understand its operating contract; do not grade it from names or frontmatter alone.
For each skill, state its purpose and activation boundary, distinct value, overlap with neighboring skills, source-backed strengths and concrete defects, assumptions about tools/hosts/permissions, smallest justified improvement, and a KEEP / CHANGE / REMOVE recommendation. Explicitly include unchanged skills; do not manufacture a defect to populate the assessment. Reuse the shared skill instruction quality rubric without making experiments, parallel agents or new reports compulsory.
State the covered skill count, whether inventory and necessary references were complete, and which evidence is unavailable. A source-level assessment is not an observed measure of runtime efficacy or installed-host discovery. Remain read-only.
Release history
Only query historical releases when the user asks about previous versions, release
history, regression origin, or comparison. Use list_plugin_releases, following
next_cursor as needed even through empty pages. Results are in attachment order
and may include unpublished releases; do not equate order with version or publication
chronology. Local Git history or supplied older archives are separate evidence.
Retrieve only the needed historical releases, using returned release IDs with
get_owned_plugin_archive. Its downloaded release describes that snapshot; plugin
metadata can describe the current release. Downloading history does not restore it.
For a named comparison, use the exact requested release. For regression analysis,
inspect the minimum relevant set to locate unaffected/affected behavior, distinguishing
source changes from runtime regressions proven to have shipped.
Output
Prefer a compact summary: identity/version, selected hosts, skills, integrations, authoritative files, useful constraints, and concrete issues with source locations. Preserve the requested terminology and level of detail. Do not manufacture findings, modify source, write a report file, publish, restore, or run mutating helpers merely because inspection was requested.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

