ecosystem-standards

name	ecosystem-standards
plugin	agent-scaffolders
description	Provides active execution protocols to rigorously audit how code, directory structures, and agent actions comply with the authoritative ecosystem specs. Trigger when validating new skills, plugins, or workflows.
allowed-tools	Bash, Read, Write

Dependencies

This skill requires Python 3.8+ and standard library only. No external packages needed.

To install this skill's dependencies:

pip-compile ./requirements.in
pip install -r ./requirements.txt

See ./requirements.txt for the dependency lockfile (currently empty — standard library only).

---

Ecosystem Standards Review Protocol

This skill details how to perform an audit on new or existing capabilities (Skills, Plugins, Workflows, Sub-Agents, and Hooks) against authoritative ecosystem specifications to ensure they are created, installed, and structured correctly.

Instructions

When invoked to review a codebase component or a planned extension:

1. Identify the Component Type: Determine if the subject is a Plugin boundary, an Agent Skill, an Antigravity Workflow/Rule, a Sub-Agent, or a Hook.
2. Recall the Specs: Before reviewing, read the relevant specification file found in the ecosystem-authoritative-sources skill library.
   • Path: ./references/*.md
3. Perform Rigorous Audit:
   • Structure: Does the directory schema match the standard (./plugin.json, my-skill/SKILL.md)? Are all supporting files strictly organized into the official optional directories (scripts/, references/, assets/) rather than cluttering the skill root?
   • Manifest Schema: Does plugin.json follow the authoritative schema? Check:
     • name is kebab-case (lowercase, hyphens, no spaces)
     • version uses semver (e.g., 0.1.0, not 1.0)
     • author is an object {"name": "..."}, NOT a string
     • No author.url field (not in spec)
     • No commands_dir or skills_dir fields (auto-discovered)
     • skills, agents, hooks, commands, scripts, dependencies arrays are documentation-only (ignored by runtime, OK to keep for human readability)
     • See references/plugins.md in ecosystem-authoritative-sources for the full schema
   • Naming: Verify the skill name uses the gerund form (verb + -ing, e.g., analyzing-spreadsheets). Reject generic nouns. Ensure the name is 1-64 lowercase alphanumeric chars/hyphens only, contains NO consecutive hyphens (--), and EXACTLY matches the parent directory name.
   • Content: Does the YAML frontmatter adhere precisely to rules (description 1-1024 chars, compatibility max 500 chars, metadata strictly string-to-string keys/values)? Provide the recommendation to run skills-ref validate ./my-skill to definitively catch parse errors.
   • Description Viewpoint: Ensure the description is written strictly in the third person ("Extracts text", not "I extract text") and isn't overly vague.
   • Progressive Disclosure: For Skills, is the SKILL.md file appropriately constrained (< 500 lines) with extraneous detail pushed to one-level deep reference files? .
4. Produce Feedback: Provide explicit, granular feedback outlining exactly which ecosystem constraints were violated and concrete suggestions for fixing them. Ensure your feedback is actionable.