Skip to content

Scope the contributor skill to this repository and give it one home - #93

Merged
mzored merged 4 commits into
mainfrom
fix/contributor-skill-scope
Sep 2, 2026
Merged

Scope the contributor skill to this repository and give it one home#93
mzored merged 4 commits into
mainfrom
fix/contributor-skill-scope

Conversation

@mzored

@mzored mzored commented Sep 2, 2026

Copy link
Copy Markdown
Owner

User-visible result

Contributors get the dogfood skill on both hosts from one text, and the shipped plugin stops loading inside its own repository, where it is the thing under test rather than the authority.

This supersedes #71 and #82 and lands the uncommitted working tree that was sitting in the shared checkout. All three were attempts at the same thing and they pulled in different directions.

What each contributed

  • fix: scope contributor skills to the SkipHow repository #82's packaging half (c476d79), taken as is. _plain_marketplace copied the whole .agents tree into the Codex marketplace source. It now copies the manifest alone, so a contributor-only skill under .agents never reaches the payload. .claude/settings.json and .codex/config.toml disable the shipped plugin in this repository.
  • dogfood records how the cross-host review is run #71's skill text (51f1469, 01dac71), taken as is. It records how to tell what actually reached an agent's context, that a path-based scan under-counts because cd .../references && cat tracked-work.md never contains the path, how to reproduce before naming a cause, and how to run the review on the other host.
  • fix: scope contributor skills to the SkipHow repository #82's streamlining of the skill text (d88e17f), dropped. It removed the material above. The session that produced this pull request needed all three disciplines and had to rediscover two of them from scratch, so the evidence favors keeping them.
  • The uncommitted working tree, taken and completed. It replaced the duplicated Codex copy with a symlink and asserted the pairing in a test. That change fails every isolated install test on its own, which is why it was never committed; it is correct once the packaging half above is in.

Why the symlink rather than the second file

.agents/skills/dogfood/SKILL.md and .claude/skills/dogfood/SKILL.md were identical regular files. Two identical files are the defect 2.16.0 removed everywhere else in this repository: they drift at the first edit to either, and nothing tells the editor the other exists. tests/test_package.py now asserts that the Claude copy is a real directory, the Codex path is a symlink to it, both resolve to the same place, and the skill's own name survives the indirection.

Scope

Contributor tooling and host packaging only. plugins/skiphow/ is unchanged, so no VERSION bump.

Verification

  • python3 scripts/check.py --base origin/main — passed
  • python3 scripts/check.py --pytest tests/ -q — 176 passed, one more than main
  • python3 scripts/check_hosts.py --require-codex-validator --skip-install — Claude package validation PASS; Codex package validation and both isolated installs UNVERIFIED, no Codex plugin validator on this machine
  • git diff --check — clean

Confirmed directly that the symlink alone, without the packaging fix, fails seven tests in tests/test_hosts.py with "marketplace source must contain ordinary files and directories only", and that the two together pass.

🤖 Generated with Claude Code

mzored and others added 4 commits September 2, 2026 21:36
The codex invocation was re-derived from scratch every time: the stdin
redirect it hangs without, the model flag a ChatGPT account refuses, the
timeout binary this machine does not have, and where the verdict starts
in the log. It also records the two things that make the review worth
running — the qualifying bar from AGENTS.md in the prompt, and checking
git log -S before blaming a sentence for a run that predates it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Two open pull requests and one uncommitted working tree were three
attempts at the same thing, pulling in different directions. This
lands the coherent result.

The Codex copy of the dogfood skill was a second identical file. Two
identical files are the defect 2.16.0 spent itself removing everywhere
else, and they drift at the first edit to either. .agents/skills/dogfood
is now a symlink to the Claude copy, with a test asserting the pairing,
so there is one text and one place to edit it.

That symlink is only safe because the marketplace source no longer
copies the whole .agents tree. It now copies the manifest alone, so a
contributor-only skill under .agents never reaches the Codex payload.
Without that, every isolated install test fails on the symlink, which
is why the working tree carrying this test was never committed.

The skill text is the longer version, which records how to read what
reached an agent's context, how to reproduce before naming a cause,
and how to run the review on the other host. The competing revision
removed that material. This session needed all three and had to
rediscover two of them, so the evidence favors keeping them.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@mzored
mzored merged commit 5245247 into main Sep 2, 2026
1 check passed
@mzored
mzored deleted the fix/contributor-skill-scope branch September 2, 2026 17:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant