1
0
mirror of synced 2025-12-19 18:06:02 -05:00

Add stop criteria and common mistakes to os-support skill

Help LLMs know when to stop fetching:
- Package queries: stop after os-packages.json
- Distro support: stop after supported-os.json
- glibc queries: stop after supported-os.json

Add common mistakes section warning against:
- Looking for non-existent .md versions of JSON files
- Looking for README.md (not part of the graph)
- Fetching both JSON files when only one is needed

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Rich Lander
2025-12-15 14:04:19 -08:00
parent 9a997b58cb
commit 51e7641d9b

View File

@@ -2,6 +2,18 @@
*Core Rules from SKILL.md apply: follow `_links` for navigation, use `_embedded` first.*
## Stop Criteria
Know when you're done:
| Query Type | Stop When | File Contains |
|------------|-----------|---------------|
| Package dependencies | You have `os-packages.json` | Complete `packages[]` list for each distro/release |
| Distro support | You have `supported-os.json` | All supported `distributions[]` and `libc[]` requirements |
| glibc/musl version | You have `supported-os.json` | `libc[]` array with versions per architecture |
**Do NOT** look for markdown versions (`.md`) of these JSON files—they don't exist. The JSON files are complete and authoritative.
## Navigation Flow (3 fetches)
```
@@ -128,3 +140,12 @@ Common distributions in `supported-os.json`:
- Alpine uses musl libc, not glibc
- `architectures` field indicates supported CPU architectures
- Skip `-rendered` links unless you need human-readable markdown
## Common Mistakes
| Mistake | Why It's Wrong |
|---------|----------------|
| Looking for `os-packages.md` | Doesn't exist—`os-packages.json` has everything |
| Looking for `README.md` | Not part of the graph—follow `_links` only |
| Fetching both `supported-os.json` AND `os-packages.json` | Pick one based on your query (distro support vs packages) |
| Searching for package info in `supported-os.json` | Wrong file—use `os-packages.json` for package lists |