Skip to content

Commit f942198

Browse files
committed
meta fixups
1 parent dfafcea commit f942198

File tree

5 files changed

+10
-12
lines changed

5 files changed

+10
-12
lines changed

scripts/validate-all-skills.sh

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,12 @@ while IFS= read -r skill; do
3838
python3 "${skill}/scripts/test_skill.py" "${skill}"
3939
done < <(find skills -mindepth 1 -maxdepth 1 -type d -exec test -f "{}/SKILL.md" ';' -print | LC_ALL=C sort)
4040

41+
echo "Checking for leaked builder-only placement metadata"
42+
if grep -n -E '^## Recommended Destination$' skills/*/SKILL.md; then
43+
echo "ERROR: remove builder-only placement sections from shipped SKILL.md files" >&2
44+
exit 1
45+
fi
46+
4147
# Cross-check: files under skills/ that a fresh CI checkout will NOT see.
4248
# This catches two classes of footgun that each skill's own validate.py
4349
# cannot detect, because validate.py only inspects the working tree:

skills/eli12/SKILL.md

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -123,9 +123,3 @@ Stay in one pass for narrow questions. Extra delegation slows simple explanation
123123
3. Explaining a subsystem by listing files is not enough. Trace what actually happens.
124124
4. If the user asked for one narrow thing, do not balloon the answer into a whole-architecture tour.
125125
5. If the code is messy, say that directly. Accessibility should not sand off real complexity.
126-
127-
## Recommended Destination
128-
129-
Recommended destination: `skills/eli12`
130-
Reason: this repository already keeps canonical installable skills under `skills/<skill-name>/`.
131-
Alternative: none needed for this repository.

skills/linkedin-speak/SKILL.md

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -82,9 +82,3 @@ Default to the deterministic local translator first. It is reproducible, fast, a
8282
3. Deterministic output means the same input stays stable across runs. That is useful for tests and memes, but it also means the phrasing can feel formulaic on repeated use.
8383
4. Kagi's public LinkedIn Speak implementation is not a documented API. This skill uses a local engine by default and only emits a comparison URL for the web UI.
8484
5. Hashtag selection is keyword-driven. If the input is too vague, the fallback tags will lean generic on purpose.
85-
86-
## Recommended Destination
87-
88-
Recommended destination: `skills/linkedin-speak`
89-
Reason: this repo is already a public installable skills source that stores canonical skills under `skills/<skill-name>/`.
90-
Alternative: none needed for this repository.

skills/skill-creator-advanced/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,8 @@ Reason: <one sentence based on existing skills or current install context>
5454
Alternative: <optional fallback path if there is a reasonable second choice>
5555
```
5656

57+
Treat that recommendation as author-time context only. Do not copy it into the generated skill's `SKILL.md`, `README.md`, `AGENTS.md`, or `metadata.json`.
58+
5759
Classify the skill into a blueprint type:
5860

5961
| Blueprint | When to use | Template |

skills/skill-creator-advanced/references/placement.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,4 +144,6 @@ Reason: this repo already keeps 3 installable skills under .agents/skills
144144
Alternative: ~/.codex/skills/<skill-name>
145145
```
146146

147+
This is conversational guidance for the author before scaffolding. Do not write this block into the generated skill files or repository wrappers.
148+
147149
Then proceed unless the user overrides the destination.

0 commit comments

Comments
 (0)