@paperclipai/skills-catalog 0.3.1

package/catalog/optional/product/design-critique/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: design-critique
+description: Give a structured product design critique — user job clarity, hierarchy, affordance, error states, accessibility, and consistency — focused on what to change, in what order, and why.
+key: paperclipai/optional/product/design-critique
+recommendedForRoles:
+  - designer
+  - product
+  - engineer
+tags:
+  - design
+  - product
+  - ux
+  - review
+---
+
+# Product Design Critique
+
+A structured critique pass for a screen, flow, or component. The output is a prioritized list of changes a designer or engineer can act on — not adjectives. Critique is not redesign; recommend, do not rebuild.
+
+## When to use
+
+- A designer or engineer asks for feedback on a screen, mock, or live UI.
+- A feature is shipping and someone wants a final UX read.
+- A flow is suspected of causing user drop-off and you want a pre-research read before instrumentation.
+
+## When not to use
+
+- The user wants a redesign. That is a design project, not a critique.
+- The work is so early that no concrete artifact exists. Sketch with them instead of critiquing air.
+- You have no context on the user job. Ask for it first; design critique without user context devolves into taste.
+
+## Pre-critique context
+
+Before opening a screen, get:
+
+- **Who is the user.** Specific role and competence, not "users".
+- **What job they are doing on this screen.** One sentence.
+- **What success looks like.** What the user can do after this screen that they could not before.
+- **Where this screen sits in the larger flow.** What precedes and follows.
+
+If any of these is missing, ask. Critique without these is opinion.
+
+## The pass (in order)
+
+1. **Clarity of the user job.**
+   - Within 3 seconds of opening, is it obvious what this screen is for?
+   - Does the primary action match the user's actual job, or a designer's preferred path?
+
+2. **Visual hierarchy.**
+   - The most important thing on the screen should be the most prominent (size, weight, position, color).
+   - Secondary actions should look secondary. Tertiary should be findable but not loud.
+   - Headings should chunk content into the right groups for the task.
+
+3. **Affordance and signifiers.**
+   - Clickable things look clickable.
+   - Disabled things look disabled and explain why on hover/focus.
+   - Drag, scroll, or swipe interactions are discoverable, not hidden.
+
+4. **States.**
+   - Empty state (no data) is designed, not a blank rectangle.
+   - Loading state communicates progress, not just spins.
+   - Error states say what went wrong and what to do next, in the user's words.
+   - Success state confirms without celebrating banal actions.
+
+5. **Inputs and forms.**
+   - Labels visible, not just placeholders.
+   - Validation runs at the right time (on blur, not on every keystroke unless the user is in a known-format field).
+   - Required fields marked.
+   - Field order matches the user's mental order, not the database order.
+
+6. **Accessibility.**
+   - Sufficient color contrast (WCAG AA at minimum; AAA where reasonable).
+   - Focus order is logical for keyboard navigation.
+   - Interactive elements are reachable without a mouse.
+   - Critical information is not color-only (icons, text, position back it up).
+   - Touch targets at least 44×44 px on mobile.
+
+7. **Consistency.**
+   - Tokens, components, and patterns match the rest of the product.
+   - "Borrowed" patterns from other products are intentional, not accidental drift.
+
+8. **Copy.**
+   - Buttons are verbs that name the outcome ("Save changes" beats "Submit").
+   - Microcopy explains, does not decorate.
+   - Tone matches the product voice.
+
+9. **Edge cases.**
+   - Long content (long names, many items, RTL languages).
+   - Tiny content (one item, zero items).
+   - Slow network and offline behavior.
+   - Permissions denied.
+
+## Output format
+
+Group findings by severity, then by category. Each finding is one issue and one suggested fix.
+
+```md
+## Design critique: <screen name>
+
+### Must-fix (blocks ship)
+- **<category>:** <one-line issue>. **Try:** <one-line suggestion>.
+
+### Should-fix (before broader rollout)
+- **<category>:** <one-line issue>. **Try:** <one-line suggestion>.
+
+### Nice-to-fix (when there's room)
+- **<category>:** <one-line issue>. **Try:** <one-line suggestion>.
+
+### Strengths to keep
+- <one-line thing the design got right>
+```
+
+Always include the "strengths to keep" section. It is not flattery — it is signal to the designer about what not to change in the next round.
+
+## Anti-patterns
+
+- "I would do it differently" without saying what or why. That is preference, not critique.
+- Long critiques that bury must-fix items under nice-to-haves.
+- Suggesting net-new features under the guise of a critique.
+- Ignoring user context and grading on taste.
+- Treating a critique as approval. State approval explicitly if asked; otherwise critique is feedback, not sign-off.

package/dist/generated/catalog.json

@@ -0,0 +1,285 @@
+{
+    "schemaVersion": 1,
+    "packageName": "@paperclipai/skills-catalog",
+    "packageVersion": "0.3.1",
+    "generatedAt": "2026-05-28T03:02:49.579Z",
+    "skills": [
+        {
+            "id": "paperclipai:bundled:docs:doc-maintenance",
+            "key": "paperclipai/bundled/docs/doc-maintenance",
+            "kind": "bundled",
+            "category": "docs",
+            "slug": "doc-maintenance",
+            "name": "doc-maintenance",
+            "description": "Keep project docs aligned with recent code and feature changes — detect drift, update affected pages, and add release-relevant notes without rewriting unchanged sections.",
+            "path": "catalog/bundled/docs/doc-maintenance",
+            "entrypoint": "SKILL.md",
+            "trustLevel": "markdown_only",
+            "compatibility": "compatible",
+            "defaultInstall": false,
+            "recommendedForRoles": [
+                "engineer",
+                "product",
+                "devrel"
+            ],
+            "requires": [],
+            "tags": [
+                "docs",
+                "documentation",
+                "release-notes"
+            ],
+            "files": [
+                {
+                    "path": "SKILL.md",
+                    "kind": "skill",
+                    "sizeBytes": 4478,
+                    "sha256": "fb0353386c5e5e5e13bcbb3233f044e3dccecf371f429d6328f26c26d7cb6169"
+                }
+            ],
+            "contentHash": "sha256:2e02299210fd17c1fe1867b4ee8c144a11b6fe1fe481f83b8268cfbaaf10f9aa"
+        },
+        {
+            "id": "paperclipai:bundled:paperclip-operations:issue-triage",
+            "key": "paperclipai/bundled/paperclip-operations/issue-triage",
+            "kind": "bundled",
+            "category": "paperclip-operations",
+            "slug": "issue-triage",
+            "name": "issue-triage",
+            "description": "Triage Paperclip inbox issues that are stale, blocked, in-review, or assigned-but-not-progressing, and decide a single next action per issue (resume, reassign, unblock, escalate, or close).",
+            "path": "catalog/bundled/paperclip-operations/issue-triage",
+            "entrypoint": "SKILL.md",
+            "trustLevel": "markdown_only",
+            "compatibility": "compatible",
+            "defaultInstall": false,
+            "recommendedForRoles": [
+                "manager",
+                "ceo",
+                "engineer"
+            ],
+            "requires": [],
+            "tags": [
+                "paperclip",
+                "triage",
+                "inbox",
+                "workflow"
+            ],
+            "files": [
+                {
+                    "path": "SKILL.md",
+                    "kind": "skill",
+                    "sizeBytes": 4042,
+                    "sha256": "df5bdc8bf5e017b7ba5f70a4b5323fad51d0c323278f386580f26cf43ad09160"
+                }
+            ],
+            "contentHash": "sha256:88dc13560371fb364963782cb4f6eeb4090fcde92ee3774479428ed6b90e11c1"
+        },
+        {
+            "id": "paperclipai:bundled:paperclip-operations:task-planning",
+            "key": "paperclipai/bundled/paperclip-operations/task-planning",
+            "kind": "bundled",
+            "category": "paperclip-operations",
+            "slug": "task-planning",
+            "name": "task-planning",
+            "description": "Turn a Paperclip issue or request into a structured implementation plan with child task graph, blockers, owners, and acceptance criteria, then save it as the issue `plan` document.",
+            "path": "catalog/bundled/paperclip-operations/task-planning",
+            "entrypoint": "SKILL.md",
+            "trustLevel": "markdown_only",
+            "compatibility": "compatible",
+            "defaultInstall": false,
+            "recommendedForRoles": [
+                "manager",
+                "engineer",
+                "product"
+            ],
+            "requires": [],
+            "tags": [
+                "paperclip",
+                "planning",
+                "issues",
+                "delegation"
+            ],
+            "files": [
+                {
+                    "path": "SKILL.md",
+                    "kind": "skill",
+                    "sizeBytes": 4649,
+                    "sha256": "2ff61e12dfaa4cf8cc548529fd176f55f1b1f5292ff9dd3eb2cb331417ab5e4e"
+                }
+            ],
+            "contentHash": "sha256:4fb46a4bcefad4fd46fae48c433ee497112509a8e19fb8a7745ead44d219b498"
+        },
+        {
+            "id": "paperclipai:bundled:quality:qa-acceptance",
+            "key": "paperclipai/bundled/quality/qa-acceptance",
+            "kind": "bundled",
+            "category": "quality",
+            "slug": "qa-acceptance",
+            "name": "qa-acceptance",
+            "description": "Produce QA acceptance criteria and a manual validation plan for a feature change — golden path, edge cases, error states, performance limits, and explicit pass/fail evidence.",
+            "path": "catalog/bundled/quality/qa-acceptance",
+            "entrypoint": "SKILL.md",
+            "trustLevel": "markdown_only",
+            "compatibility": "compatible",
+            "defaultInstall": false,
+            "recommendedForRoles": [
+                "qa",
+                "engineer",
+                "product"
+            ],
+            "requires": [],
+            "tags": [
+                "qa",
+                "acceptance",
+                "validation",
+                "testing"
+            ],
+            "files": [
+                {
+                    "path": "SKILL.md",
+                    "kind": "skill",
+                    "sizeBytes": 3861,
+                    "sha256": "c631b437ab26d104af6cdb963d8f679a9341439041b3cb3ec8835f4ff551b378"
+                }
+            ],
+            "contentHash": "sha256:32372dacaf62e93454b9855968c4eec96456ba78b509f450b3dfaa48e31ef356"
+        },
+        {
+            "id": "paperclipai:bundled:software-development:github-pr-workflow",
+            "key": "paperclipai/bundled/software-development/github-pr-workflow",
+            "kind": "bundled",
+            "category": "software-development",
+            "slug": "github-pr-workflow",
+            "name": "github-pr-workflow",
+            "description": "Prepare a GitHub pull request from a feature branch — branch hygiene, commit shape, title/body, verification notes, screenshots for UI work, and replies to review comments.",
+            "path": "catalog/bundled/software-development/github-pr-workflow",
+            "entrypoint": "SKILL.md",
+            "trustLevel": "markdown_only",
+            "compatibility": "compatible",
+            "defaultInstall": false,
+            "recommendedForRoles": [
+                "engineer"
+            ],
+            "requires": [],
+            "tags": [
+                "github",
+                "pull-requests",
+                "code-review",
+                "release"
+            ],
+            "files": [
+                {
+                    "path": "SKILL.md",
+                    "kind": "skill",
+                    "sizeBytes": 3970,
+                    "sha256": "f498ec4ebb1779dea37adeb1db8a8b22316282798e35ee02e2fc5ff627d7e261"
+                }
+            ],
+            "contentHash": "sha256:90f278c89aa0711be150c1cd2456ca25620d02f36995b113ca9837d756a37f6c"
+        },
+        {
+            "id": "paperclipai:optional:browser:agent-browser",
+            "key": "paperclipai/optional/browser/agent-browser",
+            "kind": "optional",
+            "category": "browser",
+            "slug": "agent-browser",
+            "name": "agent-browser",
+            "description": "Drive a real browser to inspect or interact with a web page or app — navigate, take screenshots, read console and network, fill simple forms — for verification tasks, not unattended automation.",
+            "path": "catalog/optional/browser/agent-browser",
+            "entrypoint": "SKILL.md",
+            "trustLevel": "markdown_only",
+            "compatibility": "compatible",
+            "defaultInstall": false,
+            "recommendedForRoles": [
+                "qa",
+                "engineer",
+                "researcher"
+            ],
+            "requires": [],
+            "tags": [
+                "browser",
+                "puppeteer",
+                "playwright",
+                "verification"
+            ],
+            "files": [
+                {
+                    "path": "SKILL.md",
+                    "kind": "skill",
+                    "sizeBytes": 5133,
+                    "sha256": "362f7b9d02297782bc6f0c093f495b8a0304a75bcf4b42e5c280a42b1f757b7d"
+                }
+            ],
+            "contentHash": "sha256:eabb2c9f7b5e1a27ebb1e05a711d61433a266478154cd671a685e99e67aadea2"
+        },
+        {
+            "id": "paperclipai:optional:content:release-announcement",
+            "key": "paperclipai/optional/content/release-announcement",
+            "kind": "optional",
+            "category": "content",
+            "slug": "release-announcement",
+            "name": "release-announcement",
+            "description": "Write a release announcement — changelog, blog post, in-app note, or social post — that leads with user impact, names the audience, and includes upgrade/migration steps without filler.",
+            "path": "catalog/optional/content/release-announcement",
+            "entrypoint": "SKILL.md",
+            "trustLevel": "markdown_only",
+            "compatibility": "compatible",
+            "defaultInstall": false,
+            "recommendedForRoles": [
+                "devrel",
+                "product",
+                "writer"
+            ],
+            "requires": [],
+            "tags": [
+                "release",
+                "changelog",
+                "announcement",
+                "communication"
+            ],
+            "files": [
+                {
+                    "path": "SKILL.md",
+                    "kind": "skill",
+                    "sizeBytes": 4416,
+                    "sha256": "062810ac34e9edc89efa701fec2eee60f16949d1944cc2cae49803cb91e8cbf4"
+                }
+            ],
+            "contentHash": "sha256:f22a9ed696e6614c6db2757a149f48b3295e81f78c27d065d9cb164cf4f8a9bd"
+        },
+        {
+            "id": "paperclipai:optional:product:design-critique",
+            "key": "paperclipai/optional/product/design-critique",
+            "kind": "optional",
+            "category": "product",
+            "slug": "design-critique",
+            "name": "design-critique",
+            "description": "Give a structured product design critique — user job clarity, hierarchy, affordance, error states, accessibility, and consistency — focused on what to change, in what order, and why.",
+            "path": "catalog/optional/product/design-critique",
+            "entrypoint": "SKILL.md",
+            "trustLevel": "markdown_only",
+            "compatibility": "compatible",
+            "defaultInstall": false,
+            "recommendedForRoles": [
+                "designer",
+                "product",
+                "engineer"
+            ],
+            "requires": [],
+            "tags": [
+                "design",
+                "product",
+                "ux",
+                "review"
+            ],
+            "files": [
+                {
+                    "path": "SKILL.md",
+                    "kind": "skill",
+                    "sizeBytes": 4851,
+                    "sha256": "022e619baf6cc25725946279cb8052d22af090dd6cd6dc8c20f17867f71a5d8e"
+                }
+            ],
+            "contentHash": "sha256:429f94df398a0697042b5bbe4755b1ff1a230aa5f41d99118ad37493ac65d21c"
+        }
+    ]
+}

package/dist/scripts/build-catalog-manifest.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=build-catalog-manifest.d.ts.map

package/dist/scripts/build-catalog-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-catalog-manifest.d.ts","sourceRoot":"","sources":["../../scripts/build-catalog-manifest.ts"],"names":[],"mappings":""}

package/dist/scripts/build-catalog-manifest.js

@@ -0,0 +1,15 @@
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import { writeCatalogManifest } from "../src/catalog-builder.js";
+const packageDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const result = await writeCatalogManifest(packageDir);
+if (result.errors.length > 0) {
+    for (const error of result.errors) {
+        console.error(`- ${error}`);
+    }
+    process.exitCode = 1;
+}
+else {
+    console.log(`Wrote generated/catalog.json with ${result.manifest.skills.length} catalog skills.`);
+}
+//# sourceMappingURL=build-catalog-manifest.js.map

package/dist/scripts/build-catalog-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-catalog-manifest.js","sourceRoot":"","sources":["../../scripts/build-catalog-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACpF,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;AAEtD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CAAC,qCAAqC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,kBAAkB,CAAC,CAAC;AACpG,CAAC"}

package/dist/scripts/validate-catalog.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validate-catalog.d.ts.map

package/dist/scripts/validate-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-catalog.d.ts","sourceRoot":"","sources":["../../scripts/validate-catalog.ts"],"names":[],"mappings":""}

package/dist/scripts/validate-catalog.js

@@ -0,0 +1,15 @@
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import { validateCatalog } from "../src/catalog-builder.js";
+const packageDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const result = await validateCatalog(packageDir);
+if (result.errors.length > 0) {
+    for (const error of result.errors) {
+        console.error(`- ${error}`);
+    }
+    process.exitCode = 1;
+}
+else {
+    console.log(`Catalog manifest is valid with ${result.manifest.skills.length} catalog skills.`);
+}
+//# sourceMappingURL=validate-catalog.js.map

package/dist/scripts/validate-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-catalog.js","sourceRoot":"","sources":["../../scripts/validate-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACpF,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;AAEjD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CAAC,kCAAkC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,kBAAkB,CAAC,CAAC;AACjG,CAAC"}

package/dist/src/catalog-builder.d.ts

@@ -0,0 +1,16 @@
+import type { CatalogManifest } from "./types.js";
+interface BuildCatalogManifestOptions {
+    packageDir: string;
+    generatedAt?: string;
+}
+interface BuildCatalogManifestResult {
+    manifest: CatalogManifest;
+    errors: string[];
+}
+export declare function formatCatalogManifest(manifest: CatalogManifest): string;
+export declare function buildExpectedCatalogManifest(packageDir: string): Promise<BuildCatalogManifestResult>;
+export declare function buildCatalogManifest(options: BuildCatalogManifestOptions): Promise<BuildCatalogManifestResult>;
+export declare function validateCatalog(packageDir: string): Promise<BuildCatalogManifestResult>;
+export declare function writeCatalogManifest(packageDir: string): Promise<BuildCatalogManifestResult>;
+export {};
+//# sourceMappingURL=catalog-builder.d.ts.map

package/dist/src/catalog-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-builder.d.ts","sourceRoot":"","sources":["../../src/catalog-builder.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,eAAe,EAMhB,MAAM,YAAY,CAAC;AAgBpB,UAAU,2BAA2B;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,0BAA0B;IAClC,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAEvE;AAED,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,0BAA0B,CAAC,CAerC;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CA2BrC;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAwB7F;AAED,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,uCAQ5D"}