docs(skills): name the project Skill path an Agent can actually reach - #154
Merged
Merged
Conversation
… Skills v2 PR #95 proposed `skilld self`: a CLI command that built a local BM25 index of the workspace and answered `skilld search -p self`. ADR 0001 moved generation out of the CLI and v3 deleted the index runtime, so the command cannot exist. The value that survives is the path itself. The `skilld` Skill, the only asset an Agent installs globally, never named generate-project-skill, so no Agent could find it. Name it, and make the project Skill carry the search commands the index used to answer.
This was referenced Sep 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🔗 Linked issue
Related to #33
❓ Type of change
📚 Description
#95 proposed
skilld self: index the workspace into a local BM25 database and answerskilld search "..." -p self. ADR 0001 moved generation out of the CLI and v3 deleted the index runtime, so that command has nowhere to live. The v3 answer already exists asgenerate-project-skill, and #96 carried over its navigation ideas.What was missing is the way in.
skills/skilld/SKILL.mdis the only asset an Agent installs globally, and it never namedgenerate-project-skill,generate-package-skill, orreview-skill. An Agent asked to write a Skill from the current project had no command to reach for, and the removedauthorcommand only pointed at two of the three.The project Skill now has to carry what the index used to answer: manifest entry points, the directories an Agent reads most, and
rgcommands it can repeat. Named ignores and a 512 KB cap came from #95, which had them right.Loose end: the watch mode in #33 is still not delivered and I did not try. Re-running the Skill after a big refactor is the current story. If that turns out to be the friction people actually hit, watching is a separate change.