Add integration guide for Jetski/Cortex + Gemini to fix context overflow

This commit adds documentation and a reference implementation for
integrating antigravity-awesome-skills with Jetski/Cortex agents
without hitting the context window truncation error (issue #269).

Changes:
- New integration guide: docs/integrations/jetski-cortex.md
- Example loader: examples/jetski-gemini-loader/loader.ts
- Example README: examples/jetski-gemini-loader/README.md
- Updated FAQ: docs/users/faq.md (added context overflow section)
- Updated usage: docs/users/usage.md (added "Can I load all skills?" FAQ)

The solution follows a manifest + lazy-loading pattern:
- Use data/skills_index.json as lightweight manifest
- Only load SKILL.md files for @skill-id references in messages
- Enforce maxSkillsPerTurn limit to prevent overflow
This commit is contained in:
sck_0
2026-03-11 15:42:32 +01:00
parent 1510139496
commit a41f1a4d61
5 changed files with 468 additions and 0 deletions

View File

@@ -314,6 +314,19 @@ Usually no, but if your AI doesn't recognize a skill:
2. Check the installation path matches your tool
3. Try the explicit path: `npx antigravity-awesome-skills --claude` (or `--cursor`, `--gemini`, etc.)
### "Can I load all skills into the model at once?"
No. Even though you have 1,200+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
The intended pattern is:
- use `data/skills_index.json` (the manifest) to discover which skills exist; and
- only load the `SKILL.md` files for the specific `@skill-id` values you actually use in a conversation.
If you are building your own host/agent (e.g. Jetski/Cortex + Gemini), see:
- [`docs/integrations/jetski-cortex.md`](../integrations/jetski-cortex.md)
### "Can I create my own skills?"
Yes! Use the `@skill-creator` skill: