Skip to content

join-the-team v0.2.2 — README audit, Agent Plugins 1.0.0 compliance

Choose a tag to compare

View all tags
@jpantsjoha jpantsjoha released this 07 Aug 11:31
· 1 commit to main since this release
v0.2.2
472befd
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

join-the-team is compliant with Agent Plugins 1.0.0 — the open, vendor-neutral packaging standard announced by Google, stewarded by a Technical Steering Committee spanning Amazon, Cursor, Google, Microsoft, OpenAI and Vercel. Its skills comply with Agent Skills.

Verify it yourself: make spec-conformance.

Fixed

Three README links returned 404 on public GitHub. Inverting the skill layout in 0.2.1 made .agents/skills/ a symlink, and GitHub's web UI does not traverse symlinked directories — so the skills library, plugin-submission and operating-model-bootstrap links all broke. They now point at the real skills/ directory, verified against the public API.

Install instructions referenced the symlink. README.md, BOOTSTRAP.md and docs/install/codex.md said to copy or vendor .agents/skills/; docs/install/claude.md still described the pre-inversion direction. All corrected. A coherence bug went with them: the README said copy skills/, then told Codex users it reads .agents/skills/ — follow both and Codex found nothing.

Added

The README now documents installation, configuration, usage examples and troubleshooting — the four things the Claude Plugin Hub creator guide asks for:

  • Usage — an intent-to-skill routing table and a worked risk-tiered example
  • Configuration — the three seams: operating contract, project profile, data seams
  • Troubleshooting — six failure modes, every one observed during live installs
  • Verify the install — what to ask, and what PASS looks like

Scope of compliance, stated precisely

The standard defines exactly two component types — skills (skills/) and MCP servers (mcp.json). Commands, hooks, agents, rules and LSP servers are explicitly outside v1 (§7), so this plugin's slash commands and session-start hooks are client-specific concerns rather than conformance surface, declared as manifest extensions (§8.1).

This package does not claim .claude-plugin/ or .kimi-plugin/ as §8.2 directory extensions — those must be named after the reverse-domain namespace. Ours are ordinary top-level directories, which the standard treats as non-errors. The conformance table in the README marks each rule as spec-required or local hygiene.

Verified on four clients

Claude Code, Antigravity (agy), Codex and Kimi Code — all installing 21 skills at the standard's fixed location, from clean installs.

make lint / typecheck / test / spec-conformance → all pass
README relative links → all resolve, none via symlink
Assets 2
Loading