René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"feat: support single-skill repos with root-level SKILL.md (npx skills init default layout)","articleBody":"## Problem\n\n`npx skills init my-skill` creates a repo where `SKILL.md` lives at the **root** of the repository. Example layout:\n\n```\nmy-skill-repo/\n  SKILL.md          ← single skill at root\n  README.md\n```\n\nRunning `allagents plugin install github:org/my-skill-repo` then `allagents skills list` shows **no skills** for this repo.\n\n## Current support\n\nPR #234 added support for **multi-skill flat repos** — repos with subdirectories each containing a `SKILL.md`:\n\n```\ndakota/\n  brainstorming/SKILL.md\n  debugging/SKILL.md\n  ...\n```\n\nBut **root-level single-skill repos** (the default output of `npx skills init`) are **not** handled. The code in `skills.ts` and `transform.ts` only looks one level deep for `SKILL.md` inside subdirectories, not at the plugin root itself.\n\n## Expected behavior\n\nWhen a plugin repo has `SKILL.md` at the root (and no `skills/` subdirectory and no subdirectories with `SKILL.md`), treat the entire repo as a single skill. The skill name should be derived from the `SKILL.md` frontmatter `name` field, falling back to the repo/directory name.\n\n## Implementation notes\n\nIn `skills.ts` `getAllSkillsFromPlugins()` and `transform.ts` skill sync logic, after checking:\n1. `skills/` subdirectory → standard layout\n2. Subdirectories with `SKILL.md` → multi-skill flat layout (#234)\n\nAdd:\n3. Root `SKILL.md` exists → single-skill layout: treat `pluginPath` itself as the skill directory\n\nThe skill name can be read from the frontmatter `name` field of the root `SKILL.md`, with the directory name as fallback.\n\n## Verification\n\n```bash\n# Create a minimal root-level SKILL.md repo\nmkdir /tmp/single-skill-repo\necho '---\\nname: my-skill\\ndescription: test\\n---\\n# My skill' \u003e /tmp/single-skill-repo/SKILL.md\n\n# Install and list\nallagents plugin install /tmp/single-skill-repo\nallagents skills list\n# Expected: shows \"my-skill\" from the installed plugin\n```\n\n## Related\n\n- #232 / #234 — added flat multi-skill repo support\n- `npx skills init` always creates root-level SKILL.md repos","author":{"url":"https://github.com/christso","@type":"Person","name":"christso"},"datePublished":"2026-03-14T02:21:57.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/243/allagents/issues/243"}