Theia SKILL.md

[PierreLouisLetoquart]

Idea Description

Hi Theia maintainers,

First of all, thanks for continuously maintaining and improving the IDE :^)

Context: I am working on a Theia based IDE that has a custom extension to build dashboards that consume source-code results. For that, I have a Theia extension, and I have also customized some official Theia packages, such as debug/search-in-workspace/...

During this journey, I worked with various AI-assisted coding setups: AGENTS.md, an llms/ folder containing markdown-based skills (kind of), and plain prompt engineering. In the end, everything worked reasonably well, but my lack of deep understanding of Theia’s history, funding choices, architecture, and design decisions has been quite limiting I guess.

I am reaching out to ask whether you, as maintainers (or any long-time users of this repository), have any existing piece of txt or documentation that could help AI agents get better context about Theia.

Should we create a SKILL.md and publish it? Maybe even more than one SKILL.md, for example one for debugging, one for developing extensions, one for developing plugins, and so on.

Let me know what you think about this, and what I could do to help if you find the subject interesting :-) !

---

Note: another AI-assisted coding feature that could be very beneficial for this repository is the approach used by Next.js, where documentation sources in markdown are included inside node_modules along with an AGENTS.md file that references them.

It seems to work quite well for giving agents the right context about the environment they are working in. Maybe this could be an interesting future improvement idea as well...

[github-actions[bot]]

Hi @PierreLouisLetoquart, thanks for starting this discussion! 👋

The Theia community will take a look soon. In the meantime, you might find helpful information in:

• 📖 Theia Documentation
• ❓ FAQ
• 💬 Previous Discussions

---

💙 Eclipse Theia is built and maintained by a community of contributors and sponsors. If Theia is valuable to your work, consider sponsoring the project. For professional support, training, or consulting services, learn more about available options.

[PierreLouisLetoquart]

Maybe @eneufeld , do you have any suggestions or ideas? I'm asking because of commit d4cb16d.

[eneufeld]

Hi @PierreLouisLetoquart ,
the ideas was to maintain a .prompts/project-info.prompttemplate and dedicated project-info.prompttemplate files that would contain information about the overall architecture and then drilled down detailed information about the packages.
@ndoschek do you know what the state is here?

[PierreLouisLetoquart]

Thanks for the quick answer! What I thought was interesting about skills is that they’re well integrated into AI-assisted coding tools, such as PI or Claude Code, for example...