skills 1.4.6 → 1.4.7

package/README.md

@@ -3,7 +3,7 @@
 The CLI for the open agent skills ecosystem.
 
 <!-- agent-list:start -->
-Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [39 more](#available-agents).
+Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [41 more](#available-agents).
 <!-- agent-list:end -->
 
 ## Install a Skill
@@ -212,6 +212,7 @@ Skills can be installed to any of these agents:
 | Amp, Kimi Code CLI, Replit, Universal | `amp`, `kimi-cli`, `replit`, `universal` | `.agents/skills/` | `~/.config/agents/skills/` |
 | Antigravity | `antigravity` | `.agents/skills/` | `~/.gemini/antigravity/skills/` |
 | Augment | `augment` | `.augment/skills/` | `~/.augment/skills/` |
+| IBM Bob | `bob` | `.bob/skills/` | `~/.bob/skills/` |
 | Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
 | OpenClaw | `openclaw` | `skills/` | `~/.openclaw/skills/` |
 | Cline, Warp | `cline`, `warp` | `.agents/skills/` | `~/.agents/skills/` |
@@ -224,6 +225,7 @@ Skills can be installed to any of these agents:
 | Cursor | `cursor` | `.agents/skills/` | `~/.cursor/skills/` |
 | Deep Agents | `deepagents` | `.agents/skills/` | `~/.deepagents/agent/skills/` |
 | Droid | `droid` | `.factory/skills/` | `~/.factory/skills/` |
+| Firebender | `firebender` | `.agents/skills/` | `~/.firebender/skills/` |
 | Gemini CLI | `gemini-cli` | `.agents/skills/` | `~/.gemini/skills/` |
 | GitHub Copilot | `github-copilot` | `.agents/skills/` | `~/.copilot/skills/` |
 | Goose | `goose` | `.goose/skills/` | `~/.config/goose/skills/` |
@@ -319,6 +321,7 @@ The CLI searches for skills in these locations within a repository:
 - `skills/.system/`
 - `.agents/skills/`
 - `.augment/skills/`
+- `.bob/skills/`
 - `.claude/skills/`
 - `./skills/`
 - `.codebuddy/skills/`
@@ -433,6 +436,7 @@ Telemetry is automatically disabled in CI environments.
 - [Command Code Skills Documentation](https://commandcode.ai/docs/skills)
 - [Crush Skills Documentation](https://github.com/charmbracelet/crush?tab=readme-ov-file#agent-skills)
 - [Cursor Skills Documentation](https://cursor.com/docs/context/skills)
+- [Firebender Skills Documentation](https://docs.firebender.com/multi-agent/skills)
 - [Gemini CLI Skills Documentation](https://geminicli.com/docs/cli/skills/)
 - [GitHub Copilot Agent Skills](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills)
 - [iFlow CLI Skills Documentation](https://platform.iflow.cn/en/cli/examples/skill)

package/dist/cli.mjs

@@ -62,13 +62,48 @@ function isLocalPath(input) {
 	return isAbsolute(input) || input.startsWith("./") || input.startsWith("../") || input === "." || input === ".." || /^[a-zA-Z]:[/\\]/.test(input);
 }
 const SOURCE_ALIASES = { "coinbase/agentWallet": "coinbase/agentic-wallet-skills" };
+function decodeFragmentValue(value) {
+	try {
+		return decodeURIComponent(value);
+	} catch {
+		return value;
+	}
+}
+function looksLikeGitSource(input) {
+	if (input.startsWith("github:") || input.startsWith("gitlab:") || input.startsWith("git@")) return true;
+	if (input.startsWith("http://") || input.startsWith("https://")) try {
+		const parsed = new URL(input);
+		const pathname = parsed.pathname;
+		if (parsed.hostname === "github.com") return /^\/[^/]+\/[^/]+(?:\.git)?(?:\/tree\/[^/]+(?:\/.*)?)?\/?$/.test(pathname);
+		if (parsed.hostname === "gitlab.com") return /^\/.+?\/[^/]+(?:\.git)?(?:\/-\/tree\/[^/]+(?:\/.*)?)?\/?$/.test(pathname);
+	} catch {}
+	if (/^https?:\/\/.+\.git(?:$|[/?])/i.test(input)) return true;
+	return !input.includes(":") && !input.startsWith(".") && !input.startsWith("/") && /^([^/]+)\/([^/]+)(?:\/(.+)|@(.+))?$/.test(input);
+}
+function parseFragmentRef(input) {
+	const hashIndex = input.indexOf("#");
+	if (hashIndex < 0) return { inputWithoutFragment: input };
+	const inputWithoutFragment = input.slice(0, hashIndex);
+	const fragment = input.slice(hashIndex + 1);
+	if (!fragment || !looksLikeGitSource(inputWithoutFragment)) return { inputWithoutFragment: input };
+	const atIndex = fragment.indexOf("@");
+	if (atIndex === -1) return {
+		inputWithoutFragment,
+		ref: decodeFragmentValue(fragment)
+	};
+	const ref = fragment.slice(0, atIndex);
+	const skillFilter = fragment.slice(atIndex + 1);
+	return {
+		inputWithoutFragment,
+		ref: ref ? decodeFragmentValue(ref) : void 0,
+		skillFilter: skillFilter ? decodeFragmentValue(skillFilter) : void 0
+	};
+}
+function appendFragmentRef(input, ref, skillFilter) {
+	if (!ref) return input;
+	return `${input}#${ref}${skillFilter ? `@${skillFilter}` : ""}`;
+}
 function parseSource(input) {
-	const alias = SOURCE_ALIASES[input];
-	if (alias) input = alias;
-	const githubPrefixMatch = input.match(/^github:(.+)$/);
-	if (githubPrefixMatch) return parseSource(githubPrefixMatch[1]);
-	const gitlabPrefixMatch = input.match(/^gitlab:(.+)$/);
-	if (gitlabPrefixMatch) return parseSource(`https://gitlab.com/${gitlabPrefixMatch[1]}`);
 	if (isLocalPath(input)) {
 		const resolvedPath = resolve(input);
 		return {
@@ -77,13 +112,21 @@ function parseSource(input) {
 			localPath: resolvedPath
 		};
 	}
+	const { inputWithoutFragment, ref: fragmentRef, skillFilter: fragmentSkillFilter } = parseFragmentRef(input);
+	input = inputWithoutFragment;
+	const alias = SOURCE_ALIASES[input];
+	if (alias) input = alias;
+	const githubPrefixMatch = input.match(/^github:(.+)$/);
+	if (githubPrefixMatch) return parseSource(appendFragmentRef(githubPrefixMatch[1], fragmentRef, fragmentSkillFilter));
+	const gitlabPrefixMatch = input.match(/^gitlab:(.+)$/);
+	if (gitlabPrefixMatch) return parseSource(appendFragmentRef(`https://gitlab.com/${gitlabPrefixMatch[1]}`, fragmentRef, fragmentSkillFilter));
 	const githubTreeWithPathMatch = input.match(/github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)\/(.+)/);
 	if (githubTreeWithPathMatch) {
 		const [, owner, repo, ref, subpath] = githubTreeWithPathMatch;
 		return {
 			type: "github",
 			url: `https://github.com/${owner}/${repo}.git`,
-			ref,
+			ref: ref || fragmentRef,
 			subpath: subpath ? sanitizeSubpath(subpath) : subpath
 		};
 	}
@@ -93,7 +136,7 @@ function parseSource(input) {
 		return {
 			type: "github",
 			url: `https://github.com/${owner}/${repo}.git`,
-			ref
+			ref: ref || fragmentRef
 		};
 	}
 	const githubRepoMatch = input.match(/github\.com\/([^/]+)\/([^/]+)/);
@@ -101,7 +144,8 @@ function parseSource(input) {
 		const [, owner, repo] = githubRepoMatch;
 		return {
 			type: "github",
-			url: `https://github.com/${owner}/${repo.replace(/\.git$/, "")}.git`
+			url: `https://github.com/${owner}/${repo.replace(/\.git$/, "")}.git`,
+			...fragmentRef ? { ref: fragmentRef } : {}
 		};
 	}
 	const gitlabTreeWithPathMatch = input.match(/^(https?):\/\/([^/]+)\/(.+?)\/-\/tree\/([^/]+)\/(.+)/);
@@ -110,7 +154,7 @@ function parseSource(input) {
 		if (hostname !== "github.com" && repoPath) return {
 			type: "gitlab",
 			url: `${protocol}://${hostname}/${repoPath.replace(/\.git$/, "")}.git`,
-			ref,
+			ref: ref || fragmentRef,
 			subpath: subpath ? sanitizeSubpath(subpath) : subpath
 		};
 	}
@@ -120,7 +164,7 @@ function parseSource(input) {
 		if (hostname !== "github.com" && repoPath) return {
 			type: "gitlab",
 			url: `${protocol}://${hostname}/${repoPath.replace(/\.git$/, "")}.git`,
-			ref
+			ref: ref || fragmentRef
 		};
 	}
 	const gitlabRepoMatch = input.match(/gitlab\.com\/(.+?)(?:\.git)?\/?$/);
@@ -128,7 +172,8 @@ function parseSource(input) {
 		const repoPath = gitlabRepoMatch[1];
 		if (repoPath.includes("/")) return {
 			type: "gitlab",
-			url: `https://gitlab.com/${repoPath}.git`
+			url: `https://gitlab.com/${repoPath}.git`,
+			...fragmentRef ? { ref: fragmentRef } : {}
 		};
 	}
 	const atSkillMatch = input.match(/^([^/]+)\/([^/@]+)@(.+)$/);
@@ -137,16 +182,19 @@ function parseSource(input) {
 		return {
 			type: "github",
 			url: `https://github.com/${owner}/${repo}.git`,
-			skillFilter
+			...fragmentRef ? { ref: fragmentRef } : {},
+			skillFilter: fragmentSkillFilter || skillFilter
 		};
 	}
-	const shorthandMatch = input.match(/^([^/]+)\/([^/]+)(?:\/(.+))?$/);
+	const shorthandMatch = input.match(/^([^/]+)\/([^/]+)(?:\/(.+?))?\/?$/);
 	if (shorthandMatch && !input.includes(":") && !input.startsWith(".") && !input.startsWith("/")) {
 		const [, owner, repo, subpath] = shorthandMatch;
 		return {
 			type: "github",
 			url: `https://github.com/${owner}/${repo}.git`,
-			subpath: subpath ? sanitizeSubpath(subpath) : subpath
+			...fragmentRef ? { ref: fragmentRef } : {},
+			subpath: subpath ? sanitizeSubpath(subpath) : subpath,
+			...fragmentSkillFilter ? { skillFilter: fragmentSkillFilter } : {}
 		};
 	}
 	if (isWellKnownUrl(input)) return {
@@ -155,7 +203,8 @@ function parseSource(input) {
 	};
 	return {
 		type: "git",
-		url: input
+		url: input,
+		...fragmentRef ? { ref: fragmentRef } : {}
 	};
 }
 function isWellKnownUrl(input) {
@@ -634,6 +683,15 @@ const agents = {
 			return existsSync(join(home, ".augment"));
 		}
 	},
+	bob: {
+		name: "bob",
+		displayName: "IBM Bob",
+		skillsDir: ".bob/skills",
+		globalSkillsDir: join(home, ".bob/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".bob"));
+		}
+	},
 	"claude-code": {
 		name: "claude-code",
 		displayName: "Claude Code",
@@ -742,6 +800,15 @@ const agents = {
 			return existsSync(join(home, ".factory"));
 		}
 	},
+	firebender: {
+		name: "firebender",
+		displayName: "Firebender",
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(home, ".firebender/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".firebender"));
+		}
+	},
 	"gemini-cli": {
 		name: "gemini-cli",
 		displayName: "Gemini CLI",
@@ -1685,13 +1752,14 @@ function getGitHubToken() {
 	} catch {}
 	return null;
 }
-async function fetchSkillFolderHash(ownerRepo, skillPath, token) {
+async function fetchSkillFolderHash(ownerRepo, skillPath, token, ref) {
 	let folderPath = skillPath.replace(/\\/g, "/");
 	if (folderPath.endsWith("/SKILL.md")) folderPath = folderPath.slice(0, -9);
 	else if (folderPath.endsWith("SKILL.md")) folderPath = folderPath.slice(0, -8);
 	if (folderPath.endsWith("/")) folderPath = folderPath.slice(0, -1);
-	for (const branch of ["main", "master"]) try {
-		const url = `https://api.github.com/repos/${ownerRepo}/git/trees/${branch}?recursive=1`;
+	const branches = ref ? [ref] : ["main", "master"];
+	for (const branch of branches) try {
+		const url = `https://api.github.com/repos/${ownerRepo}/git/trees/${encodeURIComponent(branch)}?recursive=1`;
 		const headers = {
 			Accept: "application/vnd.github.v3+json",
 			"User-Agent": "skills-cli"
@@ -1822,7 +1890,7 @@ function createEmptyLocalLock() {
 		skills: {}
 	};
 }
-var version$1 = "1.4.6";
+var version$1 = "1.4.7";
 const isCancelled$1 = (value) => typeof value === "symbol";
 async function isSourcePrivate(source) {
 	const ownerRepo = parseOwnerRepo(source);
@@ -2654,13 +2722,14 @@ async function runAdd(args, options = {}) {
 					let skillFolderHash = "";
 					const skillPathValue = skillFiles[skill.name];
 					if (parsed.type === "github" && skillPathValue) {
-						const hash = await fetchSkillFolderHash(normalizedSource, skillPathValue, getGitHubToken());
+						const hash = await fetchSkillFolderHash(normalizedSource, skillPathValue, getGitHubToken(), parsed.ref);
 						if (hash) skillFolderHash = hash;
 					}
 					await addSkillToLock(skill.name, {
 						source: lockSource || normalizedSource,
 						sourceType: parsed.type,
 						sourceUrl: parsed.url,
+						ref: parsed.ref,
 						skillPath: skillPathValue,
 						skillFolderHash,
 						pluginName: skill.pluginName
@@ -2676,6 +2745,7 @@ async function runAdd(args, options = {}) {
 					const computedHash = await computeSkillFolderHash(skill.path);
 					await addSkillToLocalLock(skill.name, {
 						source: lockSource || parsed.url,
+						ref: parsed.ref,
 						sourceType: parsed.type,
 						computedHash
 					}, cwd);
@@ -3366,9 +3436,10 @@ async function runInstallFromLock(args) {
 			nodeModuleSkills.push(skillName);
 			continue;
 		}
-		const existing = bySource.get(entry.source);
+		const installSource = entry.ref ? `${entry.source}#${entry.ref}` : entry.source;
+		const existing = bySource.get(installSource);
 		if (existing) existing.skills.push(skillName);
-		else bySource.set(entry.source, {
+		else bySource.set(installSource, {
 			sourceType: entry.sourceType,
 			skills: [skillName]
 		});
@@ -3698,6 +3769,20 @@ function parseRemoveOptions(args) {
 		options
 	};
 }
+function formatSourceInput(sourceUrl, ref) {
+	if (!ref) return sourceUrl;
+	return `${sourceUrl}#${ref}`;
+}
+function buildUpdateInstallSource(entry) {
+	if (!entry.skillPath) return formatSourceInput(entry.sourceUrl, entry.ref);
+	let skillFolder = entry.skillPath;
+	if (skillFolder.endsWith("/SKILL.md")) skillFolder = skillFolder.slice(0, -9);
+	else if (skillFolder.endsWith("SKILL.md")) skillFolder = skillFolder.slice(0, -8);
+	if (skillFolder.endsWith("/")) skillFolder = skillFolder.slice(0, -1);
+	let installSource = skillFolder ? `${entry.source}/${skillFolder}` : entry.source;
+	if (entry.ref) installSource = `${installSource}#${entry.ref}`;
+	return installSource;
+}
 const __dirname = dirname(fileURLToPath(import.meta.url));
 function getVersion() {
 	try {
@@ -3951,7 +4036,7 @@ function printSkippedSkills(skipped) {
 	console.log(`${DIM}${skipped.length} skill(s) cannot be checked automatically:${RESET}`);
 	for (const skill of skipped) {
 		console.log(`  ${TEXT}•${RESET} ${skill.name} ${DIM}(${skill.reason})${RESET}`);
-		console.log(`    ${DIM}To update: ${TEXT}npx skills add ${skill.sourceUrl} -g -y${RESET}`);
+		console.log(`    ${DIM}To update: ${TEXT}npx skills add ${formatSourceInput(skill.sourceUrl, skill.ref)} -g -y${RESET}`);
 	}
 }
 async function runCheck(args = []) {
@@ -3974,7 +4059,8 @@ async function runCheck(args = []) {
 			skipped.push({
 				name: skillName,
 				reason: getSkipReason(entry),
-				sourceUrl: entry.sourceUrl
+				sourceUrl: entry.sourceUrl,
+				ref: entry.ref
 			});
 			continue;
 		}
@@ -3995,7 +4081,7 @@ async function runCheck(args = []) {
 	const updates = [];
 	const errors = [];
 	for (const [source, skills] of skillsBySource) for (const { name, entry } of skills) try {
-		const latestHash = await fetchSkillFolderHash(source, entry.skillPath, token);
+		const latestHash = await fetchSkillFolderHash(source, entry.skillPath, token, entry.ref);
 		if (!latestHash) {
 			errors.push({
 				name,
@@ -4064,12 +4150,13 @@ async function runUpdate() {
 			skipped.push({
 				name: skillName,
 				reason: getSkipReason(entry),
-				sourceUrl: entry.sourceUrl
+				sourceUrl: entry.sourceUrl,
+				ref: entry.ref
 			});
 			continue;
 		}
 		try {
-			const latestHash = await fetchSkillFolderHash(entry.source, entry.skillPath, token);
+			const latestHash = await fetchSkillFolderHash(entry.source, entry.skillPath, token, entry.ref);
 			if (latestHash && latestHash !== entry.skillFolderHash) updates.push({
 				name: skillName,
 				source: entry.source,
@@ -4093,15 +4180,7 @@ async function runUpdate() {
 	let failCount = 0;
 	for (const update of updates) {
 		console.log(`${TEXT}Updating ${update.name}...${RESET}`);
-		let installUrl = update.entry.sourceUrl;
-		if (update.entry.skillPath) {
-			let skillFolder = update.entry.skillPath;
-			if (skillFolder.endsWith("/SKILL.md")) skillFolder = skillFolder.slice(0, -9);
-			else if (skillFolder.endsWith("SKILL.md")) skillFolder = skillFolder.slice(0, -8);
-			if (skillFolder.endsWith("/")) skillFolder = skillFolder.slice(0, -1);
-			installUrl = update.entry.sourceUrl.replace(/\.git$/, "").replace(/\/$/, "");
-			installUrl = `${installUrl}/tree/main/${skillFolder}`;
-		}
+		const installUrl = buildUpdateInstallSource(update.entry);
 		const cliEntry = join(__dirname, "..", "bin", "cli.mjs");
 		if (!existsSync(cliEntry)) {
 			failCount++;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skills",
-  "version": "1.4.6",
+  "version": "1.4.7",
   "description": "The open agent skills ecosystem",
   "type": "module",
   "bin": {
@@ -39,6 +39,7 @@
     "amp",
     "antigravity",
     "augment",
+    "bob",
     "claude-code",
     "openclaw",
     "cline",
@@ -51,6 +52,7 @@
     "cursor",
     "deepagents",
     "droid",
+    "firebender",
     "gemini-cli",
     "github-copilot",
     "goose",