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
Consolidate the repository into clearer apps, tools, and layered docs areas so contributors can navigate and maintain it more reliably. Align validation, metadata sync, and CI around the same canonical workflow to reduce drift across local checks and GitHub Actions.