Repository navigation
Provide a skill for agentic coding #1936
Description
Activity
Sounds good.
- added 2 commits that reference this issue
on May 7, 2026 Hi @philipp-horstenkamp could you provide feedback on those 2 linked PRs when you have a moment? Thanks!
Closing as completed.
Hi,
I do not think that the skill will work like this. The resources are relative to the repository root, but when installing a skill, only the skill folder (https://github.com/commitizen-tools/commitizen/tree/master/.agents/skills/commitizen) and its contents are included. That prevents it from accessing the relative files.
When referencing, we would need the full URL for the MD files—probably via the llms.txt format. However, that still doesn’t put all the resources on the developer's PC and will increase latency. The referenced documents would need to be placed in the references/ subfolder of the skill. I am not sure if that is doable via links...
I am normally more in favor of having everything in the skill and reference folder. That allows for human review and "locking" the content, which is sadly necessary for security.
Also as far as i am awrare the compatibility normaly lists the agent coding systems something is compatible with. But i am less sure about that.
When referencing, we would need the full URL for the MD files
I remember full URL is less preferred because it increases token usage. Agents should be able to figure out the location of MD files by themselves.
Yes relative paths are shorter and therfore preferred. But thats only workable if the skill has a working relative path to the references if they are installed locally.
- added a commit that references this issue
on May 19, 2026
Description
Please provide an llms.txt and SKILL.md.
To integrate better and officialy into agentic workflows.
Possible Solution
Use an llms.txt converter when building your documentation and use a metaskill cor agent creation.
Additional context
https://llmstxt.org/
https://agentskills.io/home
Related issues
No response