Skip to content

Feature suggestion: Progressive Disclosure pattern for skill consolidation #17

@KIMJINWOO4

Description

@KIMJINWOO4

Clear and concise description of the problem

Description:

When you install several related skills (like vue + pinia + router + vueuse + testing), they all register separate descriptions in the system prompt. Felt like a waste of context window for things that are basically the same domain.


Suggested solution:

I tried grouping them under one SKILL.md that acts as a thin entry point, with a references/ folder for the actual knowledge loaded on demand:

vue/
├── SKILL.md           ← only this hits the system prompt
└── references/
    ├── pinia-guide.md ← loaded when needed
    ├── pinia/
    └── ...

Proof of concept: https://github.com/KIMJINWOO4/vue-skills

Could be worth considering if you plan to offer bundled skill packs in the future.

Suggested solution

Introduce an optional "skill pack" convention where related skills can be grouped under a single directory with one SKILL.md entry point and a references/ subdirectory for on-demand loading. This keeps the system prompt lightweight while preserving full knowledge depth.

Alternative

No response

Additional context

No response

Validations

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions