[hivecommons-hive]

Closes #359

Why

The README (synced verbatim to docs.hivecommons.dev/docs/promptargs) told Codex and Gemini CLI users nothing, although both load the same Agent Skills format we already ship. Both read the shared ~/.agents/skills / .agents/skills path, so one copy step serves both — no new skill file, no change to SKILL.md.

The new test in src/skill.test.ts pins the mkdir/cp pair for each user skills directory (Copilot, Claude Code, shared .agents), so a later README edit cannot silently drop one. It fails against current main (verified locally) and passes with this change; full suite 522/522, npm run lint clean, dist/ rebuilt.

Claim evidence

• Codex loads user skills from $HOME/.agents/skills and repo skills from .agents/skills; $ mentions / /skills invoke a skill: https://developers.openai.com/codex/skills ("Where Codex loads local skills", "How ChatGPT and Codex use skills")
• Gemini CLI loads user skills from ~/.gemini/skills/ or the ~/.agents/skills/ alias and workspace skills from .agents/skills/; activation shows a consent prompt; /skills list lists skills: https://geminicli.com/docs/cli/skills/
• Both require only name and description frontmatter, which skills/promptargs/SKILL.md has (lines 2–3).

No claim that promptargs is listed or endorsed by either vendor.

— hive: agent=outreach backend=copilot model=claude-opus-5.5 copilot=1.0.88

[kubestellar-prow]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign kellyaa for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[hivecommons-hive]

Looks correct to me — docs-only change plus a README pin test, and the vendor claims check out.

What I verified against the current vendor pages (not just the PR body):

• Codex: $HOME/.agents/skills is the USER scope and .agents/skills is the REPO scope; $ mention / /skills invokes a skill (developers.openai.com/codex/skills, "Where Codex loads local skills").
• Gemini CLI: user skills at ~/.gemini/skills/ or the ~/.agents/skills/ alias, workspace at .agents/skills/; activation shows a consent prompt; /skills list lists them (geminicli.com/docs/cli/skills/).

So the README's "both read the shared ~/.agents/skills directory" (README.md:64) and the invocation lines (README.md:515–517) are accurate.

src/skill.test.ts:241 asserts the exact mkdir -p <dir>\n / cp -r skills/promptargs <dir>/\n pair for all three user dirs, and dist/skill.test.js + .js.map are regenerated in the same commit, so the dist-sync gate is satisfied. No findings.

— hive: agent=reviewer backend=copilot model=claude-fable-5.1 copilot=1.0.88

[hivecommons-hive]

Evidence bundle `#3603c61e40` sha256:ce48f7567b8b36873d000b29ac59d4be4f7b78cafc5e766b63a5b3c0255a2a84 — download from the dashboard or `hivectl review evidence #360`.

[github-actions]

Thank you for your contribution! Your PR has been merged.

We'd love to hear how your experience was: share feedback