feat(skill): add root SKILL.md and document npx skills install#196
Conversation
Add a root-level SKILL.md (relative symlink to the canonical sdk/SKILL.md) so the skills CLI and the skills.sh directory discover the tinyplace skill at the top level instead of via a recursive search. Document installation via `npx skills add tinyhumansai/tiny.place` in the README. The symlink keeps a single source of truth (sdk/SKILL.md), so the root copy never drifts. Verified: `npx skills add <repo> --list` resolves exactly one skill (tinyplace) through the root symlink.
|
@Giri-Aayush is attempting to deploy a commit to the Vezures Team on Vercel. A member of the Team first needs to authorize it. |
📝 WalkthroughWalkthroughAdd a README subsection for using the repository as an agent skill, including installation and ChangesAgent skill usage
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~2 minutes Poem
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 71ea28d893
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
| @@ -0,0 +1 @@ | |||
| sdk/SKILL.md No newline at end of file | |||
There was a problem hiding this comment.
Replace root symlink with a real skill file
When users or the skills.sh/blob install path fetch the root SKILL.md through GitHub raw, this symlink is served as the literal text sdk/SKILL.md, not as the target file's YAML frontmatter. The skills discovery flow fetches raw.githubusercontent.com/.../SKILL.md to parse name and description, so the new root entry can be skipped or installed as an invalid one-line skill in exactly the discovery path this change is meant to support; make the root path contain the actual SKILL.md content instead of a symlink.
Useful? React with 👍 / 👎.
What
Make the
tinyplaceskill cleanly discoverable by theskillsecosystem (npx skills, which powers the skills.sh directory and its leaderboard):SKILL.mdas a relative symlink tosdk/SKILL.md(which itself resolves to the canonicalwebsite/public/SKILL.md). TheskillsCLI checks the repo root first, so this surfaces the skill at the top level instead of only through a recursive search, and gives the repo a cleaner directory page.npx skills add tinyhumansai/tiny.place.Why
skills.sh indexes public repos that contain a valid
SKILL.mdand ranks them by install volume; there is no submission form, so the install command (and clean top-level discovery) is how the skill gets surfaced. The skill is already published on ClawHub; this lines the GitHub repo up with the widernpx skillsecosystem (Claude Code, OpenClaw, Codex, Cursor, and 70+ other agents).Notes
website/public/SKILL.md(served attiny.place/SKILL.md).sdk/SKILL.mdis already a symlink to it, and the new rootSKILL.mdsymlinks tosdk/SKILL.md, so everything resolves to one file and nothing drifts.Verification
Confirmed the root symlink resolves to exactly one skill (
tinyplace) via theskillsCLI. All README links return HTTP 200.