skill: top-level clawdis and an Agent Plugins manifest for v1.0.1

[wangqianqianjun]

Summary

• awesome-copilot's intake looks for a plugin manifest in .github/plugin/, .plugin/ or the repository root, and lints SKILL.md with vally 0.12.0, which refuses a metadata value that is not a string. v1.0.0 fails both, so it cannot be submitted there.
• The declarations for OpenClaw and ClawHub (required binaries, operating systems, the two optional environment variables, homepage) move unchanged from metadata.openclaw to a top-level clawdis block, which ClawHub reads the same way. OpenClaw's loader reads them only from metadata, so it no longer hides the skill where it cannot run; compatibility and the skill's first step still name and check python3 and git.
• A root plugin.json in the Agent Plugins 1.0 format (the Claude Code manifest plus $schema) is the manifest Copilot CLI, VS Code and awesome-copilot read. .claude-plugin/plugin.json stays for Claude Code, and check-versions.sh fails unless the two agree field for field, apart from $schema.
• Version 1.0.1, now written in four places. ADR-026 records the decision; ADR-024, ADR-025, docs/publishing.md and both READMEs follow it.

Changed Files

• skills/envrelay/SKILL.md: metadata keeps only version: "1.0.1"; new top-level clawdis block.
• plugin.json (new): the Agent Plugins 1.0 manifest.
• .claude-plugin/plugin.json, Cargo.toml, Cargo.lock: 1.0.1.
• .github/scripts/check-versions.sh: compares the two manifests and checks the $schema.
• tests/installer.sh: the gh skill install fixture uses the new frontmatter shape.
• docs/decisions/026-frontmatter-and-manifests-for-awesome-copilot.md (new), docs/decisions/024-one-command-install.md, docs/decisions/025-site-in-its-own-repository.md, docs/publishing.md, README.md, README.zh-CN.md.

Validation

• check-versions.sh: "versions agree: 1.0.1" with no tag and with v1.0.1; exits 1 for v1.0.0.
• shellcheck: check-versions.sh, tests/installer.sh, skills/envrelay/install.sh.
• cargo fmt --check, cargo clippy --all-targets --locked with -D warnings, cargo test --locked (18 passed), cargo build --release --locked.
• Installer tests: 93 passed, 0 failed under sh, dash, bash and zsh.
• vally lint 0.12.0, the version awesome-copilot pins: passes on skills/envrelay and on the whole repository; fails on v1.0.0's SKILL.md.
• plugin.json against the Agent Plugins 1.0 schema with Ajv 8.20.0: no errors and no fields outside the specification.
• ClawHub's frontmatter parser (from convex/lib/skills/index.ts) reads the same values from the new clawdis block as from v1.0.0's metadata.openclaw.
• claude plugin validate --strict passes for ., .claude-plugin/plugin.json and skills.
• gh skill publish's checks, read from its source (the local gh 2.79 has no gh skill): extra top-level fields are not flagged, so only the expected license warning remains.
• SKILL.md is 499 lines. Link check over the READMEs, docs/publishing.md, ADR-024/025/026 and SKILL.md: 0 bad links.

🤖 Generated with Claude Code

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

[wangqianqianjun]

@codex review

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.