agentic-awesome-skills 14.0.0 → 14.2.0

package/README.md

@@ -1,9 +1,9 @@
-<!-- registry-sync: version=14.0.0; skills=1936; stars=42661; updated_at=2026-07-09T06:03:23+00:00 -->
+<!-- registry-sync: version=14.2.0; skills=1946; stars=42926; updated_at=2026-07-12T05:22:55+00:00 -->
 [![Agentic Awesome Skills social preview](apps/web-app/public/social-card.png)](https://github.com/sickn33/agentic-awesome-skills)
 
-# 🌌 Agentic Awesome Skills: 1,936+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Autohand Code, Copilot & More
+# 🌌 Agentic Awesome Skills: 1,946+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Autohand Code, Copilot & More
 
-> **Installable GitHub library of 1,936+ agentic skills for Claude Code, Cursor, Codex CLI, Autohand Code, Gemini CLI, Antigravity, and other AI coding assistants.**
+> **Installable GitHub library of 1,946+ agentic skills for Claude Code, Cursor, Codex CLI, Autohand Code, Gemini CLI, Antigravity, and other AI coding assistants.**
 
 Agentic Awesome Skills is an installable GitHub library and npm installer for reusable `SKILL.md` playbooks. It is designed for Claude Code, Cursor, Codex CLI, Autohand Code, Gemini CLI, Antigravity, Kiro, OpenCode, GitHub Copilot, and other AI coding assistants that benefit from structured operating instructions. Instead of collecting one-off prompt snippets, this repository gives you a searchable, installable catalog of skills, bundles, workflows, plugin-safe distributions, and practical docs that help agents perform recurring tasks with better context, stronger constraints, and clearer outputs.
 
@@ -13,7 +13,7 @@ You can use this repo to install a broad multi-tool skill library, start from fo
 
 The canonical project page is the GitHub repository at <https://github.com/sickn33/agentic-awesome-skills>; the hosted catalog is a companion discovery surface for search, plugins, and skill detail pages.
 
-**Start here:** [Install in 1 minute](#installation) · [Recommended plugins](#recommended-specialized-plugins) · [Compare plugin packs](https://sickn33.github.io/agentic-awesome-skills/plugins) · [Choose your tool](#choose-your-tool) · [📚 Browse 1,936+ Skills](#browse-1936-skills) · [Bundles & workflows](#bundles--workflows) · [Support the project](#support-the-project)
+**Start here:** [Install in 1 minute](#installation) · [Recommended plugins](#recommended-specialized-plugins) · [Compare plugin packs](https://sickn33.github.io/agentic-awesome-skills/plugins) · [Choose your tool](#choose-your-tool) · [📚 Browse 1,946+ Skills](#browse-1946-skills) · [Bundles & workflows](#bundles--workflows) · [Support the project](#support-the-project)
 
 [![GitHub stars](https://img.shields.io/badge/⭐%2043%2C000%2B%20Stars-gold?style=for-the-badge)](https://github.com/sickn33/agentic-awesome-skills/stargazers)
 [![Follow @AASkills_ on X](https://img.shields.io/badge/Follow-%40AASkills__-black?style=for-the-badge&logo=x)](https://x.com/AASkills_)
@@ -30,13 +30,13 @@ The canonical project page is the GitHub repository at <https://github.com/sickn
 [![OpenCode](https://img.shields.io/badge/OpenCode-CLI-gray?style=for-the-badge)](https://github.com/opencode-ai/opencode)
 [![Antigravity](https://img.shields.io/badge/Antigravity-AI%20IDE-red?style=for-the-badge)](https://github.com/sickn33/agentic-awesome-skills)
 
-**Current release: V14.0.0.** Trusted by 43k+ GitHub stargazers, this repository combines official and community skill collections with bundles, workflows, installation paths, and docs that help you go from first install to daily use quickly.
+**Current release: V14.2.0.** Trusted by 43k+ GitHub stargazers, this repository combines official and community skill collections with bundles, workflows, installation paths, and docs that help you go from first install to daily use quickly.
 
 ## Why This Repo
 
 - **Installable, not just inspirational**: use `npx agentic-awesome-skills` to put skills where your tool expects them.
 - **Built for major agent workflows**: Claude Code, Cursor, Codex CLI, Autohand Code, Gemini CLI, Antigravity, Kiro, OpenCode, Copilot, and more.
-- **Broad coverage with real utility**: 1,936+ skills across development, testing, security, infrastructure, product, and marketing.
+- **Broad coverage with real utility**: 1,946+ skills across development, testing, security, infrastructure, product, and marketing.
 - **Focused by default**: specialized plugins help you start with the web, security, data, docs, DevOps, QA, OSS, or agent/MCP workflows you actually need.
 - **Useful whether you want breadth or curation**: install the full catalog, choose a specialized plugin, start with bundles, or compare alternatives before installing.
 
@@ -48,7 +48,7 @@ The canonical project page is the GitHub repository at <https://github.com/sickn
 - [Choose Your Tool](#choose-your-tool)
 - [Quick FAQ](#quick-faq)
 - [Bundles & Workflows](#bundles--workflows)
-- [Browse 1,936+ Skills](#browse-1936-skills)
+- [Browse 1,946+ Skills](#browse-1946-skills)
 - [Troubleshooting](#troubleshooting)
 - [Stable Skills Manifest v1](#stable-skills-manifest-v1)
 - [Support the Project](#support-the-project)
@@ -159,7 +159,7 @@ Use the table above for install targets. Use specialized plugins when you are ch
 
 ### What is Agentic Awesome Skills?
 
-**Agentic Awesome Skills** (Release 14.0.0) is a large, installable skill library for AI coding assistants. It packages 1,936+ reusable `SKILL.md` playbooks, specialized plugins, bundles, workflows, generated catalogs, and a CLI installer so Claude Code, Codex CLI, Autohand Code, Cursor, Gemini CLI, Antigravity, and similar tools can reuse proven operating instructions instead of one-off prompts.
+**Agentic Awesome Skills** (Release 14.2.0) is a large, installable skill library for AI coding assistants. It packages 1,946+ reusable `SKILL.md` playbooks, specialized plugins, bundles, workflows, generated catalogs, and a CLI installer so Claude Code, Codex CLI, Autohand Code, Cursor, Gemini CLI, Antigravity, and similar tools can reuse proven operating instructions instead of one-off prompts.
 
 ### How do I install it?
 
@@ -224,7 +224,7 @@ If Antigravity starts hitting context limits with too many active skills, the ac
 
 If you use OpenCode or another `.agents/skills` host, prefer a reduced install up front instead of copying the full library into a context-sensitive runtime. The installer now supports `--risk`, `--category`, and `--tags` so you can keep the installed set narrow.
 
-## Browse 1,936+ Skills
+## Browse 1,946+ Skills
 
 Use the root repo as a landing page, then jump into the deeper surface that matches your intent.
 
@@ -329,6 +329,7 @@ Key source families include:
 
 ### Official Sources
 
+- **[aislon/uizze-mcp](https://github.com/aislon/uizze-mcp)**: Official source for the `uizze-ui-research` skill and UIZZE MCP-assisted UI research workflows.
 - **[anthropics/skills](https://github.com/anthropics/skills)**: Official Anthropic skills repository - Document manipulation (DOCX, PDF, PPTX, XLSX), Brand Guidelines, Internal Communications.
 - **[anthropics/claude-cookbooks](https://github.com/anthropics/claude-cookbooks)**: Official notebooks and recipes for building with Claude.
 - **[remotion-dev/skills](https://github.com/remotion-dev/skills)**: Official Remotion skills - Video creation in React with 28 modular rules.
@@ -363,6 +364,9 @@ Key source families include:
 
 ### Community Contributors
 
+- **[supernovae-st/nika-agents](https://github.com/supernovae-st/nika-agents)**: Official upstream source for the `nika` skill and its deterministic, budget-aware AI workflow runner (MIT skill content; AGPL-3.0 engine).
+- **[atdy/maoxuan-product-agent](https://github.com/atdy/maoxuan-product-agent)**: Source for the `product-decision-agent` skill - Chinese-first product judgment across prioritization, growth, operations, data, delivery, and cross-functional collaboration, with 36 tested scenarios (MIT).
+- **[hafiz-actyte/idea-autopsy](https://github.com/hafiz-actyte/idea-autopsy)**: Source for the `idea-autopsy` skill - business-idea validation that hunts the one sentence that kills an idea before you build: kill-list check, five hard filters, free-AI one-prompt test, and live ad-market verification (MIT).
 - **[cruisekkk/trading-ledger](https://github.com/cruisekkk/trading-ledger)**: Source for the `trading-ledger` skill - decision-quality trade journaling that captures entry thesis, plan, and emotion into the user's own Notion database (MIT).
 - **[cruisekkk/time-ledger](https://github.com/cruisekkk/time-ledger)**: Source for the `time-ledger` skill - natural-language time tracking parsed into the user's own Notion database with ask-instead-of-guessing reconciliation (MIT).
 - **[mattpocock/skills](https://github.com/mattpocock/skills)**: Source for 17 Matt Pocock workflow skills - codebase design, TDD, bug diagnosis, triage, PRDs, issues, prototyping, handoff, teaching, and skill-writing guidance (MIT).

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "agentic-awesome-skills",
-  "version": "14.0.0",
-  "description": "1,936+ agentic skills for Claude Code, Gemini CLI, Cursor, Antigravity & more. Installer CLI.",
+  "version": "14.2.0",
+  "description": "1,946+ agentic skills for Claude Code, Gemini CLI, Cursor, Antigravity & more. Installer CLI.",
   "license": "MIT",
   "scripts": {
     "validate": "node tools/scripts/run-python.js tools/scripts/validate_skills.py",
+    "validate:glossary": "bash scripts/validate-glossary.sh",
     "validate:strict": "node tools/scripts/run-python.js tools/scripts/validate_skills.py --strict",
     "audit:skills": "node tools/scripts/run-python.js tools/scripts/audit_skills.py",
     "audit:skills:strict": "node tools/scripts/run-python.js tools/scripts/audit_skills.py --strict",

package/tools/bin/install.js

@@ -33,14 +33,15 @@ function resolveDir(p) {
   return path.resolve(root, ...sanitizedSegments);
 }
 
-function parseArgs() {
-  const a = process.argv.slice(2);
+function parseArgs(argv = process.argv.slice(2)) {
+  const a = argv;
   let pathArg = null;
   let versionArg = null;
   let tagArg = null;
   let riskArg = null;
   let categoryArg = null;
   let tagsArg = null;
+  let versionInfo = false;
   let cursor = false,
     claude = false,
     gemini = false,
@@ -51,28 +52,22 @@ function parseArgs() {
 
   for (let i = 0; i < a.length; i++) {
     if (a[i] === "--help" || a[i] === "-h") return { help: true };
-    if (a[i] === "--path" && a[i + 1]) {
-      pathArg = a[++i];
+    if (a[i] === "--version") {
+      versionInfo = true;
       continue;
     }
-    if (a[i] === "--version" && a[i + 1]) {
-      versionArg = a[++i];
-      continue;
-    }
-    if (a[i] === "--tag" && a[i + 1]) {
-      tagArg = a[++i];
-      continue;
-    }
-    if (a[i] === "--risk" && a[i + 1]) {
-      riskArg = a[++i];
-      continue;
-    }
-    if (a[i] === "--category" && a[i + 1]) {
-      categoryArg = a[++i];
-      continue;
-    }
-    if (a[i] === "--tags" && a[i + 1]) {
-      tagsArg = a[++i];
+    if (["--path", "--release", "--tag", "--risk", "--category", "--tags"].includes(a[i])) {
+      const value = a[i + 1];
+      if (!value || value.startsWith("--")) {
+        throw new Error(`Option ${a[i]} requires a value.`);
+      }
+      if (a[i] === "--path") pathArg = value;
+      if (a[i] === "--release") versionArg = value;
+      if (a[i] === "--tag") tagArg = value;
+      if (a[i] === "--risk") riskArg = value;
+      if (a[i] === "--category") categoryArg = value;
+      if (a[i] === "--tags") tagsArg = value;
+      i += 1;
       continue;
     }
     if (a[i] === "--cursor") {
@@ -104,6 +99,7 @@ function parseArgs() {
       continue;
     }
     if (a[i] === "install") continue;
+    throw new Error(`Unknown option or command: ${a[i]}`);
   }
 
   return {
@@ -113,6 +109,7 @@ function parseArgs() {
     riskArg,
     categoryArg,
     tagsArg,
+    versionInfo,
     cursor,
     claude,
     gemini,
@@ -182,7 +179,8 @@ Options:
   --risk <csv>     Install only skills matching these risk labels
   --category <csv> Install only skills matching these categories
   --tags <csv>     Install only skills matching these tags
-  --version <ver>  Clone tag v<ver> (e.g. 4.6.0 -> v4.6.0)
+  --version        Print the installer version
+  --release <ver>  Clone tag v<ver> (e.g. 4.6.0 -> v4.6.0)
   --tag <tag>      Clone this tag or branch (e.g. v4.6.0, main)
 
 Examples:
@@ -193,7 +191,7 @@ Examples:
   npx agentic-awesome-skills --agy
   npx agentic-awesome-skills --path .agents/skills --category development,backend --risk safe,none
   npx agentic-awesome-skills --path .agents/skills --tags debugging,typescript-legacy-
-  npx agentic-awesome-skills --version 4.6.0
+  npx agentic-awesome-skills --release 4.6.0
   npx agentic-awesome-skills --path ./my-skills
   npx agentic-awesome-skills --claude --codex    Install to multiple targets
 `);
@@ -312,7 +310,14 @@ function assertSafeDestinationPath(dest, destRoot) {
   }
 }
 
-function copyRecursiveSync(src, dest, rootDir = src, skipGit = true, destRoot = dest) {
+function copyRecursiveSync(
+  src,
+  dest,
+  rootDir = src,
+  skipGit = true,
+  destRoot = dest,
+  selectedSkillEntries = null,
+) {
   const stats = fs.lstatSync(src);
   const resolvedSource = stats.isSymbolicLink()
     ? resolveSafeRealPath(rootDir, src)
@@ -324,6 +329,17 @@ function copyRecursiveSync(src, dest, rootDir = src, skipGit = true, destRoot =
   }
 
   const resolvedStats = fs.statSync(resolvedSource);
+  const relativeSource = path.relative(rootDir, resolvedSource);
+  if (
+    selectedSkillEntries &&
+    relativeSource &&
+    relativeSource !== "." &&
+    resolvedStats.isDirectory() &&
+    fs.existsSync(path.join(resolvedSource, "SKILL.md")) &&
+    !selectedSkillEntries.has(path.normalize(relativeSource))
+  ) {
+    return;
+  }
   if (fs.existsSync(dest) && fs.lstatSync(dest).isSymbolicLink()) {
     throw new Error(`Skipping unsafe destination symlink: ${dest}`);
   }
@@ -344,6 +360,7 @@ function copyRecursiveSync(src, dest, rootDir = src, skipGit = true, destRoot =
           rootDir,
           skipGit,
           destRoot,
+          selectedSkillEntries,
         );
       }
     } finally {
@@ -354,6 +371,56 @@ function copyRecursiveSync(src, dest, rootDir = src, skipGit = true, destRoot =
   }
 }
 
+function replaceManagedEntry(
+  src,
+  dest,
+  rootDir,
+  skipGit,
+  targetRoot,
+  selectedSkillEntries = null,
+) {
+  if (!fs.existsSync(targetRoot)) {
+    fs.mkdirSync(targetRoot, { recursive: true });
+  }
+  assertSafeDestinationPath(dest, targetRoot);
+  const stageRoot = fs.mkdtempSync(path.join(targetRoot, ".antigravity-stage-"));
+  const stagedEntry = path.join(stageRoot, "entry");
+  const backupEntry = path.join(stageRoot, "previous");
+  let movedPreviousEntry = false;
+
+  try {
+    copyRecursiveSync(
+      src,
+      stagedEntry,
+      rootDir,
+      skipGit,
+      stageRoot,
+      selectedSkillEntries,
+    );
+    if (!fs.existsSync(stagedEntry)) {
+      throw new Error(`Unable to stage managed install entry: ${src}`);
+    }
+
+    if (fs.existsSync(dest)) {
+      assertSafeDestinationPath(dest, targetRoot);
+      fs.renameSync(dest, backupEntry);
+      movedPreviousEntry = true;
+    }
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.renameSync(stagedEntry, dest);
+    if (movedPreviousEntry) {
+      fs.rmSync(backupEntry, { recursive: true, force: true });
+    }
+  } catch (error) {
+    if (movedPreviousEntry && fs.existsSync(backupEntry) && !fs.existsSync(dest)) {
+      fs.renameSync(backupEntry, dest);
+    }
+    throw error;
+  } finally {
+    fs.rmSync(stageRoot, { recursive: true, force: true });
+  }
+}
+
 /** Copy contents of repo's skills/ into target so each skill is target/skill-name/ (for Claude Code etc.). */
 function getInstallEntries(tempDir, selectors = buildInstallSelectors({})) {
   const repoSkills = path.join(tempDir, "skills");
@@ -381,18 +448,22 @@ function getInstallEntries(tempDir, selectors = buildInstallSelectors({})) {
 
 function installSkillsIntoTarget(tempDir, target, installEntries) {
   const repoSkills = path.join(tempDir, "skills");
+  const selectedSkillEntries = new Set(
+    installEntries
+      .filter((entry) => entry !== "docs")
+      .map(normalizeSourceEntry),
+  );
   installEntries.forEach((name) => {
     const destName = normalizeInstallEntry(name);
     if (destName === "docs") {
       const repoDocs = path.join(tempDir, "docs");
       const docsDest = path.join(target, "docs");
-      if (!fs.existsSync(docsDest)) fs.mkdirSync(docsDest, { recursive: true });
-      copyRecursiveSync(repoDocs, docsDest, repoDocs, true, target);
+      replaceManagedEntry(repoDocs, docsDest, repoDocs, true, target);
       return;
     }
     const src = path.join(repoSkills, normalizeSourceEntry(name));
     const dest = path.join(target, destName);
-    copyRecursiveSync(src, dest, repoSkills, true, target);
+    replaceManagedEntry(src, dest, repoSkills, true, target, selectedSkillEntries);
   });
 }
 
@@ -630,8 +701,8 @@ function installForTarget(tempDir, target, selectors = buildInstallSelectors({})
   const installEntries = getInstallEntries(tempDir, selectors);
   const managedEntries = getManagedEntries(installEntries, target);
   const previousEntries = readInstallManifest(target.path);
-  pruneRemovedEntries(target.path, previousEntries, managedEntries);
   installSkillsIntoTarget(tempDir, target.path, installEntries);
+  pruneRemovedEntries(target.path, previousEntries, managedEntries);
   writeInstallManifest(target.path, managedEntries);
   console.log(`  ✓ Installed to ${target.path}`);
 }
@@ -679,7 +750,14 @@ function getPostInstallMessages(targets, selectors = buildInstallSelectors({}))
 }
 
 function main() {
-  const opts = parseArgs();
+  let opts;
+  try {
+    opts = parseArgs();
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exitCode = 1;
+    return;
+  }
   const selectors = buildInstallSelectors(opts);
   const ref = resolveInstallRef(opts);
 
@@ -688,8 +766,13 @@ function main() {
     return;
   }
 
+  if (opts.versionInfo) {
+    console.log(packageMetadata.version);
+    return;
+  }
+
   const targets = getTargets(opts);
-  if (!targets.length || !HOME) {
+  if (!targets.length || (!HOME && !opts.pathArg)) {
     console.error(
       "Could not resolve home directory. Use --path <absolute-path>.",
     );
@@ -735,6 +818,7 @@ if (require.main === module) {
 
 module.exports = {
   copyRecursiveSync,
+  replaceManagedEntry,
   getPostInstallMessages,
   buildCloneArgs,
   buildInstallSelectors,
@@ -748,6 +832,7 @@ module.exports = {
   matchesInstallSelectors,
   normalizeInstallEntry,
   parseSelectorArg,
+  parseArgs,
   pruneRemovedEntries,
   readInstallManifest,
   resolveInstallRef,

package/tools/lib/skill-utils.js

@@ -158,6 +158,11 @@ function readSkill(skillDir, skillId) {
   tags = tags.filter(Boolean);
   const category = typeof data.category === 'string' ? data.category.trim() : '';
   const risk = typeof data.risk === 'string' ? data.risk.trim() : '';
+  const source = typeof data.source === 'string' ? data.source.trim() : '';
+  const sourceType = typeof data.source_type === 'string' ? data.source_type.trim() : '';
+  const sourceRepo = typeof data.source_repo === 'string' ? data.source_repo.trim() : '';
+  const license = typeof data.license === 'string' ? data.license.trim() : '';
+  const licenseSource = typeof data.license_source === 'string' ? data.license_source.trim() : '';
 
   return {
     id: skillId,
@@ -165,6 +170,11 @@ function readSkill(skillDir, skillId) {
     description,
     category,
     risk,
+    source,
+    sourceType,
+    sourceRepo,
+    license,
+    licenseSource,
     tags,
     path: skillPath,
     content,