agent-skill-manager 2.18.0 → 2.20.0

package/data/skill-index/addyosmani_agent-skills.json

@@ -2,8 +2,8 @@
   "repoUrl": "https://github.com/addyosmani/agent-skills.git",
   "owner": "addyosmani",
   "repo": "agent-skills",
-  "updatedAt": "2026-08-27T10:21:48.486Z",
-  "skillCount": 24,
+  "updatedAt": "2026-09-09T12:09:54.840Z",
+  "skillCount": 25,
   "skills": [
     {
       "name": "api-and-interface-design",
@@ -13,6 +13,8 @@
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/api-and-interface-design",
@@ -84,7 +86,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.402Z",
+        "evaluatedAt": "2026-09-09T12:09:54.787Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -157,12 +159,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.787Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 69,
@@ -175,7 +177,7 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.787Z",
           "evaluatedVersion": "0.0.0"
         }
       }
@@ -188,6 +190,8 @@
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/browser-testing-with-devtools",
@@ -259,7 +263,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.402Z",
+        "evaluatedAt": "2026-09-09T12:09:54.787Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -332,12 +336,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.787Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 69,
@@ -350,7 +354,7 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.787Z",
           "evaluatedVersion": "0.0.0"
         }
       }
@@ -363,6 +367,8 @@
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/ci-cd-and-automation",
@@ -434,7 +440,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.402Z",
+        "evaluatedAt": "2026-09-09T12:09:54.787Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -507,12 +513,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.787Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 77,
@@ -525,7 +531,7 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.787Z",
           "evaluatedVersion": "0.0.0"
         }
       }
@@ -538,6 +544,8 @@
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/code-review-and-quality",
@@ -609,7 +617,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.402Z",
+        "evaluatedAt": "2026-09-09T12:09:54.787Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -682,12 +690,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.789Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 77,
@@ -700,7 +708,7 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.789Z",
           "evaluatedVersion": "0.0.0"
         }
       }
@@ -713,6 +721,8 @@
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/code-simplification",
@@ -784,7 +794,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.402Z",
+        "evaluatedAt": "2026-09-09T12:09:54.787Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -857,12 +867,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.788Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 77,
@@ -875,7 +885,184 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.789Z",
+          "evaluatedVersion": "0.0.0"
+        }
+      }
+    },
+    {
+      "name": "constraint-driven-development",
+      "description": "Establishes a project's quality bar as a written contract and stops agents quietly lowering it. Interviews the user on which dimensions matter, supplies sane default thresholds when they have no number in mind, records everything in CONSTRAINTS.md, and watches the diff for a weakened bar — new @ts-ignore or eslint-disable suppressions, skipped or deleted tests, assertions stripped out, unimplemented stubs, thresholds edited down. Use when no quality bar is written down, when the user says \"set up constraints\" or \"define our standards\", when the user wants dimensions they care about — accessibility, web performance, coverage — set up as enforced constraints, when an agent keeps silencing checks or skipping tests to get to green, when you need a coverage or performance threshold and don't know what number to pick, or when an agent writes more code than anyone will read.",
+      "version": "0.0.0",
+      "license": "",
+      "creator": "",
+      "compatibility": "",
+      "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
+      "modelInvocable": true,
+      "userInvocable": true,
+      "installUrl": "github:addyosmani/agent-skills:skills/constraint-driven-development",
+      "relPath": "skills/constraint-driven-development",
+      "verified": true,
+      "tokenCount": 6920,
+      "evalSummary": {
+        "overallScore": 65,
+        "grade": "C",
+        "categories": [
+          {
+            "id": "structure",
+            "name": "Structure & completeness",
+            "score": 7,
+            "max": 10
+          },
+          {
+            "id": "description",
+            "name": "Description quality",
+            "score": 3,
+            "max": 10
+          },
+          {
+            "id": "prompt-engineering",
+            "name": "Prompt engineering",
+            "score": 7,
+            "max": 10
+          },
+          {
+            "id": "context-efficiency",
+            "name": "Context efficiency",
+            "score": 6,
+            "max": 10
+          },
+          {
+            "id": "safety",
+            "name": "Safety & guardrails",
+            "score": 7,
+            "max": 10
+          },
+          {
+            "id": "testability",
+            "name": "Testability",
+            "score": 5,
+            "max": 10
+          },
+          {
+            "id": "license",
+            "name": "License verification",
+            "score": 0,
+            "max": 10
+          },
+          {
+            "id": "naming",
+            "name": "Naming & conventions",
+            "score": 10,
+            "max": 10
+          },
+          {
+            "id": "pii",
+            "name": "PII detection",
+            "score": 10,
+            "max": 10
+          },
+          {
+            "id": "script-lint",
+            "name": "Script linting",
+            "score": 10,
+            "max": 10
+          }
+        ],
+        "evaluatedAt": "2026-09-09T12:09:54.787Z",
+        "evaluatedVersion": "0.0.0"
+      },
+      "evalSummaries": {
+        "quality": {
+          "providerId": "quality",
+          "providerVersion": "1.0.0",
+          "schemaVersion": 1,
+          "passed": true,
+          "overallScore": 65,
+          "grade": "C",
+          "categories": [
+            {
+              "id": "structure",
+              "name": "Structure & completeness",
+              "score": 7,
+              "max": 10
+            },
+            {
+              "id": "description",
+              "name": "Description quality",
+              "score": 3,
+              "max": 10
+            },
+            {
+              "id": "prompt-engineering",
+              "name": "Prompt engineering",
+              "score": 7,
+              "max": 10
+            },
+            {
+              "id": "context-efficiency",
+              "name": "Context efficiency",
+              "score": 6,
+              "max": 10
+            },
+            {
+              "id": "safety",
+              "name": "Safety & guardrails",
+              "score": 7,
+              "max": 10
+            },
+            {
+              "id": "testability",
+              "name": "Testability",
+              "score": 5,
+              "max": 10
+            },
+            {
+              "id": "license",
+              "name": "License verification",
+              "score": 0,
+              "max": 10
+            },
+            {
+              "id": "naming",
+              "name": "Naming & conventions",
+              "score": 10,
+              "max": 10
+            },
+            {
+              "id": "pii",
+              "name": "PII detection",
+              "score": 10,
+              "max": 10
+            },
+            {
+              "id": "script-lint",
+              "name": "Script linting",
+              "score": 10,
+              "max": 10
+            }
+          ],
+          "evaluatedAt": "2026-09-09T12:09:54.787Z",
+          "evaluatedVersion": "0.0.0"
+        },
+        "skill-best-practice": {
+          "providerId": "skill-best-practice",
+          "providerVersion": "1.2.0",
+          "schemaVersion": 1,
+          "passed": false,
+          "overallScore": 69,
+          "grade": "C",
+          "categories": [
+            {
+              "id": "validation",
+              "name": "Deterministic validation",
+              "score": 9,
+              "max": 13
+            }
+          ],
+          "evaluatedAt": "2026-09-09T12:09:54.787Z",
           "evaluatedVersion": "0.0.0"
         }
       }
@@ -888,12 +1075,14 @@
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/context-engineering",
       "relPath": "skills/context-engineering",
       "verified": true,
-      "tokenCount": 3021,
+      "tokenCount": 4028,
       "evalSummary": {
         "overallScore": 81,
         "grade": "B",
@@ -959,7 +1148,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.403Z",
+        "evaluatedAt": "2026-09-09T12:09:54.789Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -1032,12 +1221,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.789Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 77,
@@ -1050,27 +1239,29 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.789Z",
           "evaluatedVersion": "0.0.0"
         }
       }
     },
     {
       "name": "debugging-and-error-recovery",
-      "description": "Guides systematic root-cause debugging. Use when tests fail, builds break, behavior doesn't match expectations, or you encounter any unexpected error. Use when you need a systematic approach to finding and fixing the root cause rather than guessing.",
+      "description": "Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke, behavior doesn't match expectations, or you encounter any unexpected error. Use when you need to figure out what broke and why — a systematic approach to finding and fixing the root cause rather than guessing.",
       "version": "0.0.0",
       "license": "",
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/debugging-and-error-recovery",
       "relPath": "skills/debugging-and-error-recovery",
       "verified": true,
-      "tokenCount": 3299,
+      "tokenCount": 3325,
       "evalSummary": {
-        "overallScore": 71,
+        "overallScore": 69,
         "grade": "C",
         "categories": [
           {
@@ -1082,7 +1273,7 @@
           {
             "id": "description",
             "name": "Description quality",
-            "score": 7,
+            "score": 5,
             "max": 10
           },
           {
@@ -1134,7 +1325,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.403Z",
+        "evaluatedAt": "2026-09-09T12:09:54.789Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -1143,7 +1334,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 71,
+          "overallScore": 69,
           "grade": "C",
           "categories": [
             {
@@ -1155,7 +1346,7 @@
             {
               "id": "description",
               "name": "Description quality",
-              "score": 7,
+              "score": 5,
               "max": 10
             },
             {
@@ -1207,45 +1398,47 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.789Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
-          "overallScore": 77,
+          "overallScore": 69,
           "grade": "C",
           "categories": [
             {
               "id": "validation",
               "name": "Deterministic validation",
-              "score": 10,
+              "score": 9,
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.789Z",
           "evaluatedVersion": "0.0.0"
         }
       }
     },
     {
       "name": "deprecation-and-migration",
-      "description": "Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.",
+      "description": "Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.",
       "version": "0.0.0",
       "license": "",
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/deprecation-and-migration",
       "relPath": "skills/deprecation-and-migration",
       "verified": true,
-      "tokenCount": 3817,
+      "tokenCount": 3853,
       "evalSummary": {
-        "overallScore": 79,
+        "overallScore": 77,
         "grade": "C",
         "categories": [
           {
@@ -1257,7 +1450,7 @@
           {
             "id": "description",
             "name": "Description quality",
-            "score": 10,
+            "score": 8,
             "max": 10
           },
           {
@@ -1309,7 +1502,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.403Z",
+        "evaluatedAt": "2026-09-09T12:09:54.802Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -1318,7 +1511,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 79,
+          "overallScore": 77,
           "grade": "C",
           "categories": [
             {
@@ -1330,7 +1523,7 @@
             {
               "id": "description",
               "name": "Description quality",
-              "score": 10,
+              "score": 8,
               "max": 10
             },
             {
@@ -1382,45 +1575,47 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.804Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
-          "overallScore": 77,
+          "overallScore": 69,
           "grade": "C",
           "categories": [
             {
               "id": "validation",
               "name": "Deterministic validation",
-              "score": 10,
+              "score": 9,
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.403Z",
+          "evaluatedAt": "2026-09-09T12:09:54.804Z",
           "evaluatedVersion": "0.0.0"
         }
       }
     },
     {
       "name": "documentation-and-adrs",
-      "description": "Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.",
+      "description": "Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.",
       "version": "0.0.0",
       "license": "",
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/documentation-and-adrs",
       "relPath": "skills/documentation-and-adrs",
       "verified": true,
-      "tokenCount": 2915,
+      "tokenCount": 2941,
       "evalSummary": {
-        "overallScore": 75,
+        "overallScore": 73,
         "grade": "C",
         "categories": [
           {
@@ -1432,7 +1627,7 @@
           {
             "id": "description",
             "name": "Description quality",
-            "score": 7,
+            "score": 5,
             "max": 10
           },
           {
@@ -1484,7 +1679,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.432Z",
+        "evaluatedAt": "2026-09-09T12:09:54.802Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -1493,7 +1688,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 75,
+          "overallScore": 73,
           "grade": "C",
           "categories": [
             {
@@ -1505,7 +1700,7 @@
             {
               "id": "description",
               "name": "Description quality",
-              "score": 7,
+              "score": 5,
               "max": 10
             },
             {
@@ -1557,45 +1752,47 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.804Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
-          "overallScore": 77,
+          "overallScore": 69,
           "grade": "C",
           "categories": [
             {
               "id": "validation",
               "name": "Deterministic validation",
-              "score": 10,
+              "score": 9,
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.804Z",
           "evaluatedVersion": "0.0.0"
         }
       }
     },
     {
       "name": "doubt-driven-development",
-      "description": "Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production, security-sensitive logic, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.",
+      "description": "Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when you want every assumption cross-examined before proceeding, when stress-testing a plan for hidden failure modes, when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production auth, security-sensitive logic, a high-stakes migration, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.",
       "version": "0.0.0",
       "license": "",
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/doubt-driven-development",
       "relPath": "skills/doubt-driven-development",
       "verified": true,
-      "tokenCount": 4982,
+      "tokenCount": 5022,
       "evalSummary": {
-        "overallScore": 76,
+        "overallScore": 74,
         "grade": "C",
         "categories": [
           {
@@ -1607,7 +1804,7 @@
           {
             "id": "description",
             "name": "Description quality",
-            "score": 5,
+            "score": 3,
             "max": 10
           },
           {
@@ -1659,7 +1856,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.433Z",
+        "evaluatedAt": "2026-09-09T12:09:54.803Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -1668,7 +1865,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 76,
+          "overallScore": 74,
           "grade": "C",
           "categories": [
             {
@@ -1680,7 +1877,7 @@
             {
               "id": "description",
               "name": "Description quality",
-              "score": 5,
+              "score": 3,
               "max": 10
             },
             {
@@ -1732,12 +1929,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.805Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 69,
@@ -1750,7 +1947,7 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.805Z",
           "evaluatedVersion": "0.0.0"
         }
       }
@@ -1763,6 +1960,8 @@
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/frontend-ui-engineering",
@@ -1834,7 +2033,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.433Z",
+        "evaluatedAt": "2026-09-09T12:09:54.805Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -1907,12 +2106,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.805Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 69,
@@ -1925,27 +2124,29 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.805Z",
           "evaluatedVersion": "0.0.0"
         }
       }
     },
     {
       "name": "git-workflow-and-versioning",
-      "description": "Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.",
+      "description": "Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, splitting uncommitted work in a messy working tree into clean atomic commits, opening or reviewing a pull request (PR), pushing to a remote, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.",
       "version": "0.0.0",
       "license": "",
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/git-workflow-and-versioning",
       "relPath": "skills/git-workflow-and-versioning",
       "verified": true,
-      "tokenCount": 4168,
+      "tokenCount": 4214,
       "evalSummary": {
-        "overallScore": 73,
+        "overallScore": 71,
         "grade": "C",
         "categories": [
           {
@@ -1957,7 +2158,7 @@
           {
             "id": "description",
             "name": "Description quality",
-            "score": 5,
+            "score": 3,
             "max": 10
           },
           {
@@ -2009,7 +2210,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.433Z",
+        "evaluatedAt": "2026-09-09T12:09:54.805Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -2018,7 +2219,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 73,
+          "overallScore": 71,
           "grade": "C",
           "categories": [
             {
@@ -2030,7 +2231,7 @@
             {
               "id": "description",
               "name": "Description quality",
-              "score": 5,
+              "score": 3,
               "max": 10
             },
             {
@@ -2082,12 +2283,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.805Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 69,
@@ -2100,7 +2301,7 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.805Z",
           "evaluatedVersion": "0.0.0"
         }
       }
@@ -2113,6 +2314,8 @@
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/idea-refine",
@@ -2184,7 +2387,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.433Z",
+        "evaluatedAt": "2026-09-09T12:09:54.805Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -2193,7 +2396,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 69,
+          "overallScore": 70,
           "grade": "C",
           "categories": [
             {
@@ -2253,16 +2456,16 @@
             {
               "id": "script-lint",
               "name": "Script linting",
-              "score": 9,
+              "score": 10,
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.805Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 69,
@@ -2275,27 +2478,29 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.805Z",
           "evaluatedVersion": "0.0.0"
         }
       }
     },
     {
       "name": "incremental-implementation",
-      "description": "Delivers changes incrementally. Use when implementing any feature or change that touches more than one file. Use when you're about to write a large amount of code at once, or when a task feels too big to land in one step.",
+      "description": "Delivers changes incrementally in thin, verifiable slices. Use when implementing any feature or change that touches more than one file, or when picking up the next task from a plan. Use when rolling a change out behind a feature flag, when you're about to write a large amount of code at once, or when a task feels too big to land in one step.",
       "version": "0.0.0",
       "license": "",
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/incremental-implementation",
       "relPath": "skills/incremental-implementation",
       "verified": true,
-      "tokenCount": 3014,
+      "tokenCount": 3060,
       "evalSummary": {
-        "overallScore": 74,
+        "overallScore": 72,
         "grade": "C",
         "categories": [
           {
@@ -2307,7 +2512,7 @@
           {
             "id": "description",
             "name": "Description quality",
-            "score": 5,
+            "score": 3,
             "max": 10
           },
           {
@@ -2359,7 +2564,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.434Z",
+        "evaluatedAt": "2026-09-09T12:09:54.805Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -2368,7 +2573,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 74,
+          "overallScore": 72,
           "grade": "C",
           "categories": [
             {
@@ -2380,7 +2585,7 @@
             {
               "id": "description",
               "name": "Description quality",
-              "score": 5,
+              "score": 3,
               "max": 10
             },
             {
@@ -2432,25 +2637,25 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.805Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
-          "overallScore": 77,
+          "overallScore": 69,
           "grade": "C",
           "categories": [
             {
               "id": "validation",
               "name": "Deterministic validation",
-              "score": 10,
+              "score": 9,
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.805Z",
           "evaluatedVersion": "0.0.0"
         }
       }
@@ -2463,6 +2668,8 @@
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/interview-me",
@@ -2534,7 +2741,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.434Z",
+        "evaluatedAt": "2026-09-09T12:09:54.809Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -2607,12 +2814,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.812Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 69,
@@ -2625,7 +2832,7 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.812Z",
           "evaluatedVersion": "0.0.0"
         }
       }
@@ -2638,14 +2845,16 @@
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/observability-and-instrumentation",
       "relPath": "skills/observability-and-instrumentation",
       "verified": true,
-      "tokenCount": 3334,
+      "tokenCount": 4251,
       "evalSummary": {
-        "overallScore": 74,
+        "overallScore": 76,
         "grade": "C",
         "categories": [
           {
@@ -2681,7 +2890,7 @@
           {
             "id": "testability",
             "name": "Testability",
-            "score": 5,
+            "score": 7,
             "max": 10
           },
           {
@@ -2709,7 +2918,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.434Z",
+        "evaluatedAt": "2026-09-09T12:09:54.820Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -2718,7 +2927,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 74,
+          "overallScore": 76,
           "grade": "C",
           "categories": [
             {
@@ -2754,7 +2963,7 @@
             {
               "id": "testability",
               "name": "Testability",
-              "score": 5,
+              "score": 7,
               "max": 10
             },
             {
@@ -2782,12 +2991,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.822Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 69,
@@ -2800,7 +3009,7 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.434Z",
+          "evaluatedAt": "2026-09-09T12:09:54.822Z",
           "evaluatedVersion": "0.0.0"
         }
       }
@@ -2813,14 +3022,16 @@
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/performance-optimization",
       "relPath": "skills/performance-optimization",
       "verified": true,
-      "tokenCount": 4393,
+      "tokenCount": 6550,
       "evalSummary": {
-        "overallScore": 76,
+        "overallScore": 73,
         "grade": "C",
         "categories": [
           {
@@ -2838,13 +3049,13 @@
           {
             "id": "prompt-engineering",
             "name": "Prompt engineering",
-            "score": 9,
+            "score": 8,
             "max": 10
           },
           {
             "id": "context-efficiency",
             "name": "Context efficiency",
-            "score": 6,
+            "score": 4,
             "max": 10
           },
           {
@@ -2884,7 +3095,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.467Z",
+        "evaluatedAt": "2026-09-09T12:09:54.821Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -2893,7 +3104,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 76,
+          "overallScore": 73,
           "grade": "C",
           "categories": [
             {
@@ -2911,13 +3122,13 @@
             {
               "id": "prompt-engineering",
               "name": "Prompt engineering",
-              "score": 9,
+              "score": 8,
               "max": 10
             },
             {
               "id": "context-efficiency",
               "name": "Context efficiency",
-              "score": 6,
+              "score": 4,
               "max": 10
             },
             {
@@ -2957,12 +3168,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.467Z",
+          "evaluatedAt": "2026-09-09T12:09:54.823Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 69,
@@ -2975,7 +3186,7 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.467Z",
+          "evaluatedAt": "2026-09-09T12:09:54.823Z",
           "evaluatedVersion": "0.0.0"
         }
       }
@@ -2988,14 +3199,16 @@
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/planning-and-task-breakdown",
       "relPath": "skills/planning-and-task-breakdown",
       "verified": true,
-      "tokenCount": 3060,
+      "tokenCount": 3413,
       "evalSummary": {
-        "overallScore": 74,
+        "overallScore": 76,
         "grade": "C",
         "categories": [
           {
@@ -3013,7 +3226,7 @@
           {
             "id": "prompt-engineering",
             "name": "Prompt engineering",
-            "score": 9,
+            "score": 10,
             "max": 10
           },
           {
@@ -3025,7 +3238,7 @@
           {
             "id": "safety",
             "name": "Safety & guardrails",
-            "score": 9,
+            "score": 10,
             "max": 10
           },
           {
@@ -3059,7 +3272,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.467Z",
+        "evaluatedAt": "2026-09-09T12:09:54.822Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -3068,7 +3281,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 74,
+          "overallScore": 76,
           "grade": "C",
           "categories": [
             {
@@ -3086,7 +3299,7 @@
             {
               "id": "prompt-engineering",
               "name": "Prompt engineering",
-              "score": 9,
+              "score": 10,
               "max": 10
             },
             {
@@ -3098,7 +3311,7 @@
             {
               "id": "safety",
               "name": "Safety & guardrails",
-              "score": 9,
+              "score": 10,
               "max": 10
             },
             {
@@ -3132,12 +3345,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.467Z",
+          "evaluatedAt": "2026-09-09T12:09:54.823Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 77,
@@ -3150,27 +3363,29 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.467Z",
+          "evaluatedAt": "2026-09-09T12:09:54.823Z",
           "evaluatedVersion": "0.0.0"
         }
       }
     },
     {
       "name": "security-and-hardening",
-      "description": "Hardens code against vulnerabilities. Use when handling user input, authentication, data storage, or external integrations. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services. Use when personal data or privacy compliance (GDPR, CCPA) is involved.",
+      "description": "Hardens code against vulnerabilities. Use when auditing an input handler for vulnerabilities, when handling user input, authentication, data storage, or external integrations, or when checking a login flow is safe against the OWASP Top Ten. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services. Use when auditing dependencies for known vulnerabilities, triaging package-manager audit findings, or assessing supply-chain risk in a new package. Use when personal data or privacy compliance (GDPR, CCPA) is involved.",
       "version": "0.0.0",
       "license": "",
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/security-and-hardening",
       "relPath": "skills/security-and-hardening",
       "verified": true,
-      "tokenCount": 6955,
+      "tokenCount": 8143,
       "evalSummary": {
-        "overallScore": 69,
+        "overallScore": 67,
         "grade": "C",
         "categories": [
           {
@@ -3182,7 +3397,7 @@
           {
             "id": "description",
             "name": "Description quality",
-            "score": 5,
+            "score": 3,
             "max": 10
           },
           {
@@ -3234,7 +3449,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.467Z",
+        "evaluatedAt": "2026-09-09T12:09:54.823Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -3243,7 +3458,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 69,
+          "overallScore": 67,
           "grade": "C",
           "categories": [
             {
@@ -3255,7 +3470,7 @@
             {
               "id": "description",
               "name": "Description quality",
-              "score": 5,
+              "score": 3,
               "max": 10
             },
             {
@@ -3307,12 +3522,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.467Z",
+          "evaluatedAt": "2026-09-09T12:09:54.824Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 69,
@@ -3325,28 +3540,30 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.467Z",
+          "evaluatedAt": "2026-09-09T12:09:54.824Z",
           "evaluatedVersion": "0.0.0"
         }
       }
     },
     {
       "name": "shipping-and-launch",
-      "description": "Prepares production launches. Use when preparing to deploy to production. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.",
+      "description": "Prepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.",
       "version": "0.0.0",
       "license": "",
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/shipping-and-launch",
       "relPath": "skills/shipping-and-launch",
       "verified": true,
-      "tokenCount": 3092,
+      "tokenCount": 3517,
       "evalSummary": {
-        "overallScore": 81,
-        "grade": "B",
+        "overallScore": 79,
+        "grade": "C",
         "categories": [
           {
             "id": "structure",
@@ -3357,7 +3574,7 @@
           {
             "id": "description",
             "name": "Description quality",
-            "score": 10,
+            "score": 8,
             "max": 10
           },
           {
@@ -3409,7 +3626,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.467Z",
+        "evaluatedAt": "2026-09-09T12:09:54.824Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -3418,8 +3635,8 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 81,
-          "grade": "B",
+          "overallScore": 79,
+          "grade": "C",
           "categories": [
             {
               "id": "structure",
@@ -3430,7 +3647,7 @@
             {
               "id": "description",
               "name": "Description quality",
-              "score": 10,
+              "score": 8,
               "max": 10
             },
             {
@@ -3482,45 +3699,47 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.468Z",
+          "evaluatedAt": "2026-09-09T12:09:54.824Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
-          "overallScore": 77,
+          "overallScore": 69,
           "grade": "C",
           "categories": [
             {
               "id": "validation",
               "name": "Deterministic validation",
-              "score": 10,
+              "score": 9,
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.468Z",
+          "evaluatedAt": "2026-09-09T12:09:54.824Z",
           "evaluatedVersion": "0.0.0"
         }
       }
     },
     {
       "name": "source-driven-development",
-      "description": "Grounds every implementation decision in official documentation. Use when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.",
+      "description": "Grounds every implementation decision in official documentation. Use when you want to verify an approach against the official docs before implementing it, or when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.",
       "version": "0.0.0",
       "license": "",
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/source-driven-development",
       "relPath": "skills/source-driven-development",
       "verified": true,
-      "tokenCount": 2889,
+      "tokenCount": 2919,
       "evalSummary": {
-        "overallScore": 77,
+        "overallScore": 75,
         "grade": "C",
         "categories": [
           {
@@ -3532,7 +3751,7 @@
           {
             "id": "description",
             "name": "Description quality",
-            "score": 7,
+            "score": 5,
             "max": 10
           },
           {
@@ -3584,7 +3803,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.467Z",
+        "evaluatedAt": "2026-09-09T12:09:54.824Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -3593,7 +3812,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 77,
+          "overallScore": 75,
           "grade": "C",
           "categories": [
             {
@@ -3605,7 +3824,7 @@
             {
               "id": "description",
               "name": "Description quality",
-              "score": 7,
+              "score": 5,
               "max": 10
             },
             {
@@ -3657,45 +3876,47 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.468Z",
+          "evaluatedAt": "2026-09-09T12:09:54.824Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
-          "overallScore": 77,
+          "overallScore": 69,
           "grade": "C",
           "categories": [
             {
               "id": "validation",
               "name": "Deterministic validation",
-              "score": 10,
+              "score": 9,
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.468Z",
+          "evaluatedAt": "2026-09-09T12:09:54.824Z",
           "evaluatedVersion": "0.0.0"
         }
       }
     },
     {
       "name": "spec-driven-development",
-      "description": "Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.",
+      "description": "Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when drafting a PRD or requirements document with objectives and scope, or when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.",
       "version": "0.0.0",
       "license": "",
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/spec-driven-development",
       "relPath": "skills/spec-driven-development",
       "verified": true,
-      "tokenCount": 3675,
+      "tokenCount": 3699,
       "evalSummary": {
-        "overallScore": 77,
+        "overallScore": 75,
         "grade": "C",
         "categories": [
           {
@@ -3707,7 +3928,7 @@
           {
             "id": "description",
             "name": "Description quality",
-            "score": 8,
+            "score": 6,
             "max": 10
           },
           {
@@ -3759,7 +3980,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.467Z",
+        "evaluatedAt": "2026-09-09T12:09:54.831Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -3768,7 +3989,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 77,
+          "overallScore": 75,
           "grade": "C",
           "categories": [
             {
@@ -3780,7 +4001,7 @@
             {
               "id": "description",
               "name": "Description quality",
-              "score": 8,
+              "score": 6,
               "max": 10
             },
             {
@@ -3832,12 +4053,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.468Z",
+          "evaluatedAt": "2026-09-09T12:09:54.832Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 69,
@@ -3850,27 +4071,29 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.468Z",
+          "evaluatedAt": "2026-09-09T12:09:54.832Z",
           "evaluatedVersion": "0.0.0"
         }
       }
     },
     {
       "name": "test-driven-development",
-      "description": "Drives development with tests. Use when implementing any logic, fixing any bug, or changing any behavior. Use when you need to prove that code works, when a bug report arrives, or when you're about to modify existing functionality.",
+      "description": "Drives development with tests using the red-green-refactor loop. Use when implementing any logic, fixing any bug, or changing any behavior. Use when you need to prove that code works, when a bug report arrives, or when you're about to modify existing functionality.",
       "version": "0.0.0",
       "license": "",
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/test-driven-development",
       "relPath": "skills/test-driven-development",
       "verified": true,
-      "tokenCount": 5119,
+      "tokenCount": 5127,
       "evalSummary": {
-        "overallScore": 78,
+        "overallScore": 76,
         "grade": "C",
         "categories": [
           {
@@ -3882,7 +4105,7 @@
           {
             "id": "description",
             "name": "Description quality",
-            "score": 7,
+            "score": 5,
             "max": 10
           },
           {
@@ -3934,7 +4157,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.467Z",
+        "evaluatedAt": "2026-09-09T12:09:54.836Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -3943,7 +4166,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 78,
+          "overallScore": 76,
           "grade": "C",
           "categories": [
             {
@@ -3955,7 +4178,7 @@
             {
               "id": "description",
               "name": "Description quality",
-              "score": 7,
+              "score": 5,
               "max": 10
             },
             {
@@ -4007,45 +4230,47 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.468Z",
+          "evaluatedAt": "2026-09-09T12:09:54.837Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
-          "overallScore": 77,
+          "overallScore": 69,
           "grade": "C",
           "categories": [
             {
               "id": "validation",
               "name": "Deterministic validation",
-              "score": 10,
+              "score": 9,
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.468Z",
+          "evaluatedAt": "2026-09-09T12:09:54.837Z",
           "evaluatedVersion": "0.0.0"
         }
       }
     },
     {
       "name": "using-agent-skills",
-      "description": "Discovers and invokes agent skills. Use when starting a session or when you need to discover which skill applies to the current task. This is the meta-skill that governs how all other skills are discovered and invoked.",
+      "description": "Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all other skills are discovered and invoked.",
       "version": "0.0.0",
       "license": "",
       "creator": "",
       "compatibility": "",
       "allowedTools": [],
+      "tags": [],
+      "dependencies": [],
       "modelInvocable": true,
       "userInvocable": true,
       "installUrl": "github:addyosmani/agent-skills:skills/using-agent-skills",
       "relPath": "skills/using-agent-skills",
       "verified": true,
-      "tokenCount": 2671,
+      "tokenCount": 2700,
       "evalSummary": {
-        "overallScore": 73,
+        "overallScore": 71,
         "grade": "C",
         "categories": [
           {
@@ -4057,7 +4282,7 @@
           {
             "id": "description",
             "name": "Description quality",
-            "score": 7,
+            "score": 5,
             "max": 10
           },
           {
@@ -4109,7 +4334,7 @@
             "max": 10
           }
         ],
-        "evaluatedAt": "2026-08-27T10:21:48.484Z",
+        "evaluatedAt": "2026-09-09T12:09:54.837Z",
         "evaluatedVersion": "0.0.0"
       },
       "evalSummaries": {
@@ -4118,7 +4343,7 @@
           "providerVersion": "1.0.0",
           "schemaVersion": 1,
           "passed": true,
-          "overallScore": 73,
+          "overallScore": 71,
           "grade": "C",
           "categories": [
             {
@@ -4130,7 +4355,7 @@
             {
               "id": "description",
               "name": "Description quality",
-              "score": 7,
+              "score": 5,
               "max": 10
             },
             {
@@ -4182,12 +4407,12 @@
               "max": 10
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.484Z",
+          "evaluatedAt": "2026-09-09T12:09:54.837Z",
           "evaluatedVersion": "0.0.0"
         },
         "skill-best-practice": {
           "providerId": "skill-best-practice",
-          "providerVersion": "1.1.0",
+          "providerVersion": "1.2.0",
           "schemaVersion": 1,
           "passed": false,
           "overallScore": 77,
@@ -4200,7 +4425,7 @@
               "max": 13
             }
           ],
-          "evaluatedAt": "2026-08-27T10:21:48.484Z",
+          "evaluatedAt": "2026-09-09T12:09:54.837Z",
           "evaluatedVersion": "0.0.0"
         }
       }
@@ -4212,7 +4437,7 @@
       "name": "addyosmani-agent-skills-data-ai",
       "description": "Data, analytics, AI, model, prompt, agent, and automation skills. Derived from addyosmani/agent-skills.",
       "author": "ASM (addyosmani/agent-skills)",
-      "createdAt": "2026-08-27T10:21:48.486Z",
+      "createdAt": "2026-09-09T12:09:54.840Z",
       "tags": [
         "repo-derived",
         "inferred",
@@ -4253,6 +4478,12 @@
           "description": "Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity.",
           "version": "0.0.0"
         },
+        {
+          "name": "constraint-driven-development",
+          "installUrl": "github:addyosmani/agent-skills:skills/constraint-driven-development",
+          "description": "Establishes a project's quality bar as a written contract and stops agents quietly lowering it. Interviews the user on which dimensions matter, supplies sane default thresholds when they have no number in mind, records everything in CONSTRAINTS.md, and watches the diff for a weakened bar — new @ts-ignore or eslint-disable suppressions, skipped or deleted tests, assertions stripped out, unimplemented stubs, thresholds edited down. Use when no quality bar is written down, when the user says \"set up constraints\" or \"define our standards\", when the user wants dimensions they care about — accessibility, web performance, coverage — set up as enforced constraints, when an agent keeps silencing checks or skipping tests to get to green, when you need a coverage or performance threshold and don't know what number to pick, or when an agent writes more code than anyone will read.",
+          "version": "0.0.0"
+        },
         {
           "name": "context-engineering",
           "installUrl": "github:addyosmani/agent-skills:skills/context-engineering",
@@ -4262,25 +4493,25 @@
         {
           "name": "debugging-and-error-recovery",
           "installUrl": "github:addyosmani/agent-skills:skills/debugging-and-error-recovery",
-          "description": "Guides systematic root-cause debugging. Use when tests fail, builds break, behavior doesn't match expectations, or you encounter any unexpected error. Use when you need a systematic approach to finding and fixing the root cause rather than guessing.",
+          "description": "Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke, behavior doesn't match expectations, or you encounter any unexpected error. Use when you need to figure out what broke and why — a systematic approach to finding and fixing the root cause rather than guessing.",
           "version": "0.0.0"
         },
         {
           "name": "deprecation-and-migration",
           "installUrl": "github:addyosmani/agent-skills:skills/deprecation-and-migration",
-          "description": "Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.",
+          "description": "Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.",
           "version": "0.0.0"
         },
         {
           "name": "documentation-and-adrs",
           "installUrl": "github:addyosmani/agent-skills:skills/documentation-and-adrs",
-          "description": "Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.",
+          "description": "Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.",
           "version": "0.0.0"
         },
         {
           "name": "doubt-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/doubt-driven-development",
-          "description": "Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production, security-sensitive logic, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.",
+          "description": "Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when you want every assumption cross-examined before proceeding, when stress-testing a plan for hidden failure modes, when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production auth, security-sensitive logic, a high-stakes migration, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.",
           "version": "0.0.0"
         },
         {
@@ -4292,7 +4523,7 @@
         {
           "name": "git-workflow-and-versioning",
           "installUrl": "github:addyosmani/agent-skills:skills/git-workflow-and-versioning",
-          "description": "Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.",
+          "description": "Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, splitting uncommitted work in a messy working tree into clean atomic commits, opening or reviewing a pull request (PR), pushing to a remote, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.",
           "version": "0.0.0"
         },
         {
@@ -4304,7 +4535,7 @@
         {
           "name": "incremental-implementation",
           "installUrl": "github:addyosmani/agent-skills:skills/incremental-implementation",
-          "description": "Delivers changes incrementally. Use when implementing any feature or change that touches more than one file. Use when you're about to write a large amount of code at once, or when a task feels too big to land in one step.",
+          "description": "Delivers changes incrementally in thin, verifiable slices. Use when implementing any feature or change that touches more than one file, or when picking up the next task from a plan. Use when rolling a change out behind a feature flag, when you're about to write a large amount of code at once, or when a task feels too big to land in one step.",
           "version": "0.0.0"
         },
         {
@@ -4334,37 +4565,37 @@
         {
           "name": "security-and-hardening",
           "installUrl": "github:addyosmani/agent-skills:skills/security-and-hardening",
-          "description": "Hardens code against vulnerabilities. Use when handling user input, authentication, data storage, or external integrations. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services. Use when personal data or privacy compliance (GDPR, CCPA) is involved.",
+          "description": "Hardens code against vulnerabilities. Use when auditing an input handler for vulnerabilities, when handling user input, authentication, data storage, or external integrations, or when checking a login flow is safe against the OWASP Top Ten. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services. Use when auditing dependencies for known vulnerabilities, triaging package-manager audit findings, or assessing supply-chain risk in a new package. Use when personal data or privacy compliance (GDPR, CCPA) is involved.",
           "version": "0.0.0"
         },
         {
           "name": "shipping-and-launch",
           "installUrl": "github:addyosmani/agent-skills:skills/shipping-and-launch",
-          "description": "Prepares production launches. Use when preparing to deploy to production. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.",
+          "description": "Prepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.",
           "version": "0.0.0"
         },
         {
           "name": "source-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/source-driven-development",
-          "description": "Grounds every implementation decision in official documentation. Use when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.",
+          "description": "Grounds every implementation decision in official documentation. Use when you want to verify an approach against the official docs before implementing it, or when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.",
           "version": "0.0.0"
         },
         {
           "name": "spec-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/spec-driven-development",
-          "description": "Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.",
+          "description": "Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when drafting a PRD or requirements document with objectives and scope, or when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.",
           "version": "0.0.0"
         },
         {
           "name": "test-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/test-driven-development",
-          "description": "Drives development with tests. Use when implementing any logic, fixing any bug, or changing any behavior. Use when you need to prove that code works, when a bug report arrives, or when you're about to modify existing functionality.",
+          "description": "Drives development with tests using the red-green-refactor loop. Use when implementing any logic, fixing any bug, or changing any behavior. Use when you need to prove that code works, when a bug report arrives, or when you're about to modify existing functionality.",
           "version": "0.0.0"
         },
         {
           "name": "using-agent-skills",
           "installUrl": "github:addyosmani/agent-skills:skills/using-agent-skills",
-          "description": "Discovers and invokes agent skills. Use when starting a session or when you need to discover which skill applies to the current task. This is the meta-skill that governs how all other skills are discovered and invoked.",
+          "description": "Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all other skills are discovered and invoked.",
           "version": "0.0.0"
         }
       ],
@@ -4380,7 +4611,7 @@
       "name": "addyosmani-agent-skills-devops",
       "description": "Deployment, CI/CD, infrastructure, cloud, Docker, Kubernetes, and automation skills. Derived from addyosmani/agent-skills.",
       "author": "ASM (addyosmani/agent-skills)",
-      "createdAt": "2026-08-27T10:21:48.486Z",
+      "createdAt": "2026-09-09T12:09:54.840Z",
       "tags": [
         "repo-derived",
         "inferred",
@@ -4397,22 +4628,28 @@
           "description": "Automates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to automate quality gates, configure test runners in CI, or establish deployment strategies.",
           "version": "0.0.0"
         },
+        {
+          "name": "constraint-driven-development",
+          "installUrl": "github:addyosmani/agent-skills:skills/constraint-driven-development",
+          "description": "Establishes a project's quality bar as a written contract and stops agents quietly lowering it. Interviews the user on which dimensions matter, supplies sane default thresholds when they have no number in mind, records everything in CONSTRAINTS.md, and watches the diff for a weakened bar — new @ts-ignore or eslint-disable suppressions, skipped or deleted tests, assertions stripped out, unimplemented stubs, thresholds edited down. Use when no quality bar is written down, when the user says \"set up constraints\" or \"define our standards\", when the user wants dimensions they care about — accessibility, web performance, coverage — set up as enforced constraints, when an agent keeps silencing checks or skipping tests to get to green, when you need a coverage or performance threshold and don't know what number to pick, or when an agent writes more code than anyone will read.",
+          "version": "0.0.0"
+        },
         {
           "name": "deprecation-and-migration",
           "installUrl": "github:addyosmani/agent-skills:skills/deprecation-and-migration",
-          "description": "Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.",
+          "description": "Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.",
           "version": "0.0.0"
         },
         {
           "name": "documentation-and-adrs",
           "installUrl": "github:addyosmani/agent-skills:skills/documentation-and-adrs",
-          "description": "Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.",
+          "description": "Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.",
           "version": "0.0.0"
         },
         {
           "name": "doubt-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/doubt-driven-development",
-          "description": "Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production, security-sensitive logic, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.",
+          "description": "Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when you want every assumption cross-examined before proceeding, when stress-testing a plan for hidden failure modes, when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production auth, security-sensitive logic, a high-stakes migration, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.",
           "version": "0.0.0"
         },
         {
@@ -4424,7 +4661,7 @@
         {
           "name": "git-workflow-and-versioning",
           "installUrl": "github:addyosmani/agent-skills:skills/git-workflow-and-versioning",
-          "description": "Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.",
+          "description": "Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, splitting uncommitted work in a messy working tree into clean atomic commits, opening or reviewing a pull request (PR), pushing to a remote, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.",
           "version": "0.0.0"
         },
         {
@@ -4439,22 +4676,34 @@
           "description": "Instruments code so production behavior is visible and diagnosable. Use when adding logging, metrics, tracing, or alerting. Use when shipping any feature that runs in production and you need evidence it works. Use when production issues are reported but you can't tell what happened from the available data.",
           "version": "0.0.0"
         },
+        {
+          "name": "security-and-hardening",
+          "installUrl": "github:addyosmani/agent-skills:skills/security-and-hardening",
+          "description": "Hardens code against vulnerabilities. Use when auditing an input handler for vulnerabilities, when handling user input, authentication, data storage, or external integrations, or when checking a login flow is safe against the OWASP Top Ten. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services. Use when auditing dependencies for known vulnerabilities, triaging package-manager audit findings, or assessing supply-chain risk in a new package. Use when personal data or privacy compliance (GDPR, CCPA) is involved.",
+          "version": "0.0.0"
+        },
         {
           "name": "shipping-and-launch",
           "installUrl": "github:addyosmani/agent-skills:skills/shipping-and-launch",
-          "description": "Prepares production launches. Use when preparing to deploy to production. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.",
+          "description": "Prepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.",
           "version": "0.0.0"
         },
         {
           "name": "source-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/source-driven-development",
-          "description": "Grounds every implementation decision in official documentation. Use when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.",
+          "description": "Grounds every implementation decision in official documentation. Use when you want to verify an approach against the official docs before implementing it, or when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.",
           "version": "0.0.0"
         },
         {
           "name": "spec-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/spec-driven-development",
-          "description": "Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.",
+          "description": "Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when drafting a PRD or requirements document with objectives and scope, or when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.",
+          "version": "0.0.0"
+        },
+        {
+          "name": "using-agent-skills",
+          "installUrl": "github:addyosmani/agent-skills:skills/using-agent-skills",
+          "description": "Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all other skills are discovered and invoked.",
           "version": "0.0.0"
         }
       ],
@@ -4470,7 +4719,7 @@
       "name": "addyosmani-agent-skills-engineering",
       "description": "Coding, debugging, testing, architecture, review, and software engineering skills. Derived from addyosmani/agent-skills.",
       "author": "ASM (addyosmani/agent-skills)",
-      "createdAt": "2026-08-27T10:21:48.486Z",
+      "createdAt": "2026-09-09T12:09:54.840Z",
       "tags": [
         "repo-derived",
         "inferred",
@@ -4511,28 +4760,34 @@
           "description": "Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity.",
           "version": "0.0.0"
         },
+        {
+          "name": "constraint-driven-development",
+          "installUrl": "github:addyosmani/agent-skills:skills/constraint-driven-development",
+          "description": "Establishes a project's quality bar as a written contract and stops agents quietly lowering it. Interviews the user on which dimensions matter, supplies sane default thresholds when they have no number in mind, records everything in CONSTRAINTS.md, and watches the diff for a weakened bar — new @ts-ignore or eslint-disable suppressions, skipped or deleted tests, assertions stripped out, unimplemented stubs, thresholds edited down. Use when no quality bar is written down, when the user says \"set up constraints\" or \"define our standards\", when the user wants dimensions they care about — accessibility, web performance, coverage — set up as enforced constraints, when an agent keeps silencing checks or skipping tests to get to green, when you need a coverage or performance threshold and don't know what number to pick, or when an agent writes more code than anyone will read.",
+          "version": "0.0.0"
+        },
         {
           "name": "debugging-and-error-recovery",
           "installUrl": "github:addyosmani/agent-skills:skills/debugging-and-error-recovery",
-          "description": "Guides systematic root-cause debugging. Use when tests fail, builds break, behavior doesn't match expectations, or you encounter any unexpected error. Use when you need a systematic approach to finding and fixing the root cause rather than guessing.",
+          "description": "Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke, behavior doesn't match expectations, or you encounter any unexpected error. Use when you need to figure out what broke and why — a systematic approach to finding and fixing the root cause rather than guessing.",
           "version": "0.0.0"
         },
         {
           "name": "deprecation-and-migration",
           "installUrl": "github:addyosmani/agent-skills:skills/deprecation-and-migration",
-          "description": "Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.",
+          "description": "Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.",
           "version": "0.0.0"
         },
         {
           "name": "documentation-and-adrs",
           "installUrl": "github:addyosmani/agent-skills:skills/documentation-and-adrs",
-          "description": "Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.",
+          "description": "Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.",
           "version": "0.0.0"
         },
         {
           "name": "doubt-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/doubt-driven-development",
-          "description": "Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production, security-sensitive logic, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.",
+          "description": "Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when you want every assumption cross-examined before proceeding, when stress-testing a plan for hidden failure modes, when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production auth, security-sensitive logic, a high-stakes migration, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.",
           "version": "0.0.0"
         },
         {
@@ -4544,7 +4799,7 @@
         {
           "name": "git-workflow-and-versioning",
           "installUrl": "github:addyosmani/agent-skills:skills/git-workflow-and-versioning",
-          "description": "Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.",
+          "description": "Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, splitting uncommitted work in a messy working tree into clean atomic commits, opening or reviewing a pull request (PR), pushing to a remote, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.",
           "version": "0.0.0"
         },
         {
@@ -4556,7 +4811,7 @@
         {
           "name": "incremental-implementation",
           "installUrl": "github:addyosmani/agent-skills:skills/incremental-implementation",
-          "description": "Delivers changes incrementally. Use when implementing any feature or change that touches more than one file. Use when you're about to write a large amount of code at once, or when a task feels too big to land in one step.",
+          "description": "Delivers changes incrementally in thin, verifiable slices. Use when implementing any feature or change that touches more than one file, or when picking up the next task from a plan. Use when rolling a change out behind a feature flag, when you're about to write a large amount of code at once, or when a task feels too big to land in one step.",
           "version": "0.0.0"
         },
         {
@@ -4574,25 +4829,25 @@
         {
           "name": "security-and-hardening",
           "installUrl": "github:addyosmani/agent-skills:skills/security-and-hardening",
-          "description": "Hardens code against vulnerabilities. Use when handling user input, authentication, data storage, or external integrations. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services. Use when personal data or privacy compliance (GDPR, CCPA) is involved.",
+          "description": "Hardens code against vulnerabilities. Use when auditing an input handler for vulnerabilities, when handling user input, authentication, data storage, or external integrations, or when checking a login flow is safe against the OWASP Top Ten. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services. Use when auditing dependencies for known vulnerabilities, triaging package-manager audit findings, or assessing supply-chain risk in a new package. Use when personal data or privacy compliance (GDPR, CCPA) is involved.",
           "version": "0.0.0"
         },
         {
           "name": "source-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/source-driven-development",
-          "description": "Grounds every implementation decision in official documentation. Use when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.",
+          "description": "Grounds every implementation decision in official documentation. Use when you want to verify an approach against the official docs before implementing it, or when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.",
           "version": "0.0.0"
         },
         {
           "name": "spec-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/spec-driven-development",
-          "description": "Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.",
+          "description": "Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when drafting a PRD or requirements document with objectives and scope, or when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.",
           "version": "0.0.0"
         },
         {
           "name": "test-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/test-driven-development",
-          "description": "Drives development with tests. Use when implementing any logic, fixing any bug, or changing any behavior. Use when you need to prove that code works, when a bug report arrives, or when you're about to modify existing functionality.",
+          "description": "Drives development with tests using the red-green-refactor loop. Use when implementing any logic, fixing any bug, or changing any behavior. Use when you need to prove that code works, when a bug report arrives, or when you're about to modify existing functionality.",
           "version": "0.0.0"
         }
       ],
@@ -4608,7 +4863,7 @@
       "name": "addyosmani-agent-skills-frontend-design",
       "description": "Frontend, UI, UX, visual design, component, theme, and landing-page skills. Derived from addyosmani/agent-skills.",
       "author": "ASM (addyosmani/agent-skills)",
-      "createdAt": "2026-08-27T10:21:48.486Z",
+      "createdAt": "2026-09-09T12:09:54.840Z",
       "tags": [
         "repo-derived",
         "inferred",
@@ -4637,10 +4892,22 @@
           "description": "Automates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to automate quality gates, configure test runners in CI, or establish deployment strategies.",
           "version": "0.0.0"
         },
+        {
+          "name": "constraint-driven-development",
+          "installUrl": "github:addyosmani/agent-skills:skills/constraint-driven-development",
+          "description": "Establishes a project's quality bar as a written contract and stops agents quietly lowering it. Interviews the user on which dimensions matter, supplies sane default thresholds when they have no number in mind, records everything in CONSTRAINTS.md, and watches the diff for a weakened bar — new @ts-ignore or eslint-disable suppressions, skipped or deleted tests, assertions stripped out, unimplemented stubs, thresholds edited down. Use when no quality bar is written down, when the user says \"set up constraints\" or \"define our standards\", when the user wants dimensions they care about — accessibility, web performance, coverage — set up as enforced constraints, when an agent keeps silencing checks or skipping tests to get to green, when you need a coverage or performance threshold and don't know what number to pick, or when an agent writes more code than anyone will read.",
+          "version": "0.0.0"
+        },
         {
           "name": "debugging-and-error-recovery",
           "installUrl": "github:addyosmani/agent-skills:skills/debugging-and-error-recovery",
-          "description": "Guides systematic root-cause debugging. Use when tests fail, builds break, behavior doesn't match expectations, or you encounter any unexpected error. Use when you need a systematic approach to finding and fixing the root cause rather than guessing.",
+          "description": "Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke, behavior doesn't match expectations, or you encounter any unexpected error. Use when you need to figure out what broke and why — a systematic approach to finding and fixing the root cause rather than guessing.",
+          "version": "0.0.0"
+        },
+        {
+          "name": "documentation-and-adrs",
+          "installUrl": "github:addyosmani/agent-skills:skills/documentation-and-adrs",
+          "description": "Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.",
           "version": "0.0.0"
         },
         {
@@ -4670,19 +4937,19 @@
         {
           "name": "security-and-hardening",
           "installUrl": "github:addyosmani/agent-skills:skills/security-and-hardening",
-          "description": "Hardens code against vulnerabilities. Use when handling user input, authentication, data storage, or external integrations. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services. Use when personal data or privacy compliance (GDPR, CCPA) is involved.",
+          "description": "Hardens code against vulnerabilities. Use when auditing an input handler for vulnerabilities, when handling user input, authentication, data storage, or external integrations, or when checking a login flow is safe against the OWASP Top Ten. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services. Use when auditing dependencies for known vulnerabilities, triaging package-manager audit findings, or assessing supply-chain risk in a new package. Use when personal data or privacy compliance (GDPR, CCPA) is involved.",
           "version": "0.0.0"
         },
         {
           "name": "source-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/source-driven-development",
-          "description": "Grounds every implementation decision in official documentation. Use when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.",
+          "description": "Grounds every implementation decision in official documentation. Use when you want to verify an approach against the official docs before implementing it, or when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.",
           "version": "0.0.0"
         },
         {
           "name": "spec-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/spec-driven-development",
-          "description": "Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.",
+          "description": "Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when drafting a PRD or requirements document with objectives and scope, or when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.",
           "version": "0.0.0"
         }
       ],
@@ -4698,7 +4965,7 @@
       "name": "addyosmani-agent-skills-marketing",
       "description": "Marketing, growth, SEO, ASO, affiliate, sales, and conversion skills. Derived from addyosmani/agent-skills.",
       "author": "ASM (addyosmani/agent-skills)",
-      "createdAt": "2026-08-27T10:21:48.486Z",
+      "createdAt": "2026-09-09T12:09:54.840Z",
       "tags": [
         "repo-derived",
         "inferred",
@@ -4715,10 +4982,22 @@
           "description": "Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch.",
           "version": "0.0.0"
         },
+        {
+          "name": "documentation-and-adrs",
+          "installUrl": "github:addyosmani/agent-skills:skills/documentation-and-adrs",
+          "description": "Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.",
+          "version": "0.0.0"
+        },
+        {
+          "name": "doubt-driven-development",
+          "installUrl": "github:addyosmani/agent-skills:skills/doubt-driven-development",
+          "description": "Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when you want every assumption cross-examined before proceeding, when stress-testing a plan for hidden failure modes, when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production auth, security-sensitive logic, a high-stakes migration, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.",
+          "version": "0.0.0"
+        },
         {
           "name": "git-workflow-and-versioning",
           "installUrl": "github:addyosmani/agent-skills:skills/git-workflow-and-versioning",
-          "description": "Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.",
+          "description": "Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, splitting uncommitted work in a messy working tree into clean atomic commits, opening or reviewing a pull request (PR), pushing to a remote, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.",
           "version": "0.0.0"
         },
         {
@@ -4740,7 +5019,7 @@
       "name": "addyosmani-agent-skills-product-business",
       "description": "Product, strategy, PRD, planning, finance, resume, and business workflow skills. Derived from addyosmani/agent-skills.",
       "author": "ASM (addyosmani/agent-skills)",
-      "createdAt": "2026-08-27T10:21:48.486Z",
+      "createdAt": "2026-09-09T12:09:54.840Z",
       "tags": [
         "repo-derived",
         "inferred",
@@ -4751,10 +5030,16 @@
         "agent-skills"
       ],
       "skills": [
+        {
+          "name": "deprecation-and-migration",
+          "installUrl": "github:addyosmani/agent-skills:skills/deprecation-and-migration",
+          "description": "Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.",
+          "version": "0.0.0"
+        },
         {
           "name": "doubt-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/doubt-driven-development",
-          "description": "Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production, security-sensitive logic, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.",
+          "description": "Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when you want every assumption cross-examined before proceeding, when stress-testing a plan for hidden failure modes, when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production auth, security-sensitive logic, a high-stakes migration, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.",
           "version": "0.0.0"
         },
         {
@@ -4778,7 +5063,13 @@
         {
           "name": "shipping-and-launch",
           "installUrl": "github:addyosmani/agent-skills:skills/shipping-and-launch",
-          "description": "Prepares production launches. Use when preparing to deploy to production. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.",
+          "description": "Prepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.",
+          "version": "0.0.0"
+        },
+        {
+          "name": "spec-driven-development",
+          "installUrl": "github:addyosmani/agent-skills:skills/spec-driven-development",
+          "description": "Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when drafting a PRD or requirements document with objectives and scope, or when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.",
           "version": "0.0.0"
         }
       ],
@@ -4794,7 +5085,7 @@
       "name": "addyosmani-agent-skills-research",
       "description": "Research, academic, literature-review, citation, paper, and analysis skills. Derived from addyosmani/agent-skills.",
       "author": "ASM (addyosmani/agent-skills)",
-      "createdAt": "2026-08-27T10:21:48.486Z",
+      "createdAt": "2026-09-09T12:09:54.840Z",
       "tags": [
         "repo-derived",
         "inferred",
@@ -4826,7 +5117,19 @@
         {
           "name": "doubt-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/doubt-driven-development",
-          "description": "Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production, security-sensitive logic, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.",
+          "description": "Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when you want every assumption cross-examined before proceeding, when stress-testing a plan for hidden failure modes, when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production auth, security-sensitive logic, a high-stakes migration, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.",
+          "version": "0.0.0"
+        },
+        {
+          "name": "git-workflow-and-versioning",
+          "installUrl": "github:addyosmani/agent-skills:skills/git-workflow-and-versioning",
+          "description": "Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, splitting uncommitted work in a messy working tree into clean atomic commits, opening or reviewing a pull request (PR), pushing to a remote, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.",
+          "version": "0.0.0"
+        },
+        {
+          "name": "source-driven-development",
+          "installUrl": "github:addyosmani/agent-skills:skills/source-driven-development",
+          "description": "Grounds every implementation decision in official documentation. Use when you want to verify an approach against the official docs before implementing it, or when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.",
           "version": "0.0.0"
         }
       ],
@@ -4842,7 +5145,7 @@
       "name": "addyosmani-agent-skills-writing",
       "description": "Writing, editing, documentation, publishing, and content-production skills. Derived from addyosmani/agent-skills.",
       "author": "ASM (addyosmani/agent-skills)",
-      "createdAt": "2026-08-27T10:21:48.486Z",
+      "createdAt": "2026-09-09T12:09:54.840Z",
       "tags": [
         "repo-derived",
         "inferred",
@@ -4853,28 +5156,40 @@
         "agent-skills"
       ],
       "skills": [
+        {
+          "name": "constraint-driven-development",
+          "installUrl": "github:addyosmani/agent-skills:skills/constraint-driven-development",
+          "description": "Establishes a project's quality bar as a written contract and stops agents quietly lowering it. Interviews the user on which dimensions matter, supplies sane default thresholds when they have no number in mind, records everything in CONSTRAINTS.md, and watches the diff for a weakened bar — new @ts-ignore or eslint-disable suppressions, skipped or deleted tests, assertions stripped out, unimplemented stubs, thresholds edited down. Use when no quality bar is written down, when the user says \"set up constraints\" or \"define our standards\", when the user wants dimensions they care about — accessibility, web performance, coverage — set up as enforced constraints, when an agent keeps silencing checks or skipping tests to get to green, when you need a coverage or performance threshold and don't know what number to pick, or when an agent writes more code than anyone will read.",
+          "version": "0.0.0"
+        },
         {
           "name": "documentation-and-adrs",
           "installUrl": "github:addyosmani/agent-skills:skills/documentation-and-adrs",
-          "description": "Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.",
+          "description": "Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.",
           "version": "0.0.0"
         },
         {
           "name": "git-workflow-and-versioning",
           "installUrl": "github:addyosmani/agent-skills:skills/git-workflow-and-versioning",
-          "description": "Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.",
+          "description": "Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, splitting uncommitted work in a messy working tree into clean atomic commits, opening or reviewing a pull request (PR), pushing to a remote, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.",
           "version": "0.0.0"
         },
         {
           "name": "incremental-implementation",
           "installUrl": "github:addyosmani/agent-skills:skills/incremental-implementation",
-          "description": "Delivers changes incrementally. Use when implementing any feature or change that touches more than one file. Use when you're about to write a large amount of code at once, or when a task feels too big to land in one step.",
+          "description": "Delivers changes incrementally in thin, verifiable slices. Use when implementing any feature or change that touches more than one file, or when picking up the next task from a plan. Use when rolling a change out behind a feature flag, when you're about to write a large amount of code at once, or when a task feels too big to land in one step.",
           "version": "0.0.0"
         },
         {
           "name": "source-driven-development",
           "installUrl": "github:addyosmani/agent-skills:skills/source-driven-development",
-          "description": "Grounds every implementation decision in official documentation. Use when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.",
+          "description": "Grounds every implementation decision in official documentation. Use when you want to verify an approach against the official docs before implementing it, or when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.",
+          "version": "0.0.0"
+        },
+        {
+          "name": "spec-driven-development",
+          "installUrl": "github:addyosmani/agent-skills:skills/spec-driven-development",
+          "description": "Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when drafting a PRD or requirements document with objectives and scope, or when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.",
           "version": "0.0.0"
         }
       ],