pm-claude-skills 29.2.0 → 29.2.1

package/README.md

@@ -261,6 +261,13 @@ Most skill repos are a folder of prompts. This one is a **system** — measured,
 
 ## 🚀 Quick Install (2 minutes)
 
+> **Not sure where to start?** Pick by what you want:
+> - **Just try it (0 install):** open the **[live Playground](https://mohitagw15856.github.io/pm-claude-skills/)** and run any skill.
+> - **Use it in Claude Code:** `npx pm-claude-skills add --agent claude` (or the `/plugin` route below).
+> - **Have it in every session:** add the MCP server (one line, below).
+>
+> ⚠️ **You don't need `npm install pm-claude-skills`** — it's a CLI, not a library, so there's nothing to import. Use `npx pm-claude-skills …` (it always runs the latest). `npm install` just downloads it and does nothing on its own.
+
 **With the [`skills`](https://github.com/vercel-labs/skills) CLI** (the open agent-skills installer that works across Claude Code, Cursor, Codex, OpenCode & 60+ agents) — pick from all 232 interactively:
 
 ```bash

package/bin/cli.mjs

@@ -154,6 +154,11 @@ function list() {
 
 const HELP = `pm-claude-skills — install professional Agent Skills into any AI coding tool.
 
+👋 New here? Two fast ways to start:
+  • No install — try any skill in your browser: https://mohitagw15856.github.io/pm-claude-skills/
+  • In your editor — run:  npx pm-claude-skills add --agent claude
+(This is a CLI, not a library — you don't need \`npm install\`; \`npx …\` always runs the latest.)
+
 Usage:
   npx pm-claude-skills add --agent <claude|hermes|codex|openclaw|cursor|windsurf|aider> [--target <path>] [--link] [--dry-run]
   npx pm-claude-skills list

package/bin/postinstall.mjs

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+// Printed right after `npm i pm-claude-skills`, so a newcomer isn't left staring at
+// `npm fund` wondering what to do. This package is a CLI, not a library — there's
+// nothing to import; you RUN it. Must never fail an install: everything is wrapped
+// and it always exits 0.
+try {
+  // Stay quiet in CI / non-interactive installs (e.g. this repo's own `npm ci`),
+  // where a marketing banner is just noise.
+  if (process.env.CI || !process.stdout.isTTY) process.exit(0);
+
+  const B = (s) => `\x1b[1m${s}\x1b[0m`;
+  const D = (s) => `\x1b[2m${s}\x1b[0m`;
+  const A = (s) => `\x1b[38;5;208m${s}\x1b[0m`; // accent
+  const lines = [
+    '',
+    A('  ✅ pm-claude-skills installed — 232 professional Agent Skills.'),
+    '',
+    "  This is a CLI, not a library — nothing to import. Here's what to run:",
+    '',
+    `  ${B('npx pm-claude-skills list')}                  ${D('# browse the skills')}`,
+    `  ${B('npx pm-claude-skills add --agent claude')}    ${D('# install into Claude Code')}`,
+    `  ${D('                                              # (or: cursor · codex · windsurf · aider · hermes)')}`,
+    '',
+    `  ${B('No install at all?')} Try any skill free in your browser:`,
+    `  ${A('https://mohitagw15856.github.io/pm-claude-skills/')}`,
+    '',
+    `  ${B('Want them in every Claude session?')} Add the MCP server:`,
+    `  ${B('claude mcp add pm-skills -- npx -y pm-claude-skills-mcp')}`,
+    '',
+    D('  Tip: you can skip `npm install` entirely — `npx pm-claude-skills …` always runs the latest.'),
+    '',
+  ];
+  process.stdout.write(lines.join('\n') + '\n');
+} catch {
+  /* never break an install over a banner */
+}
+process.exit(0);

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "pm-claude-skills",
-  "version": "29.2.0",
+  "version": "29.2.1",
   "type": "module",
   "mcpName": "io.github.mohitagw15856/pm-claude-skills",
-  "description": "206 professional Agent Skills (SKILL.md) + subagents + slash commands for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes. Install into any AI coding tool with: npx pm-claude-skills add --agent <tool>.",
+  "description": "232 professional Agent Skills (SKILL.md) + subagents + slash commands for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes. It's a CLI, not a library: run `npx pm-claude-skills add --agent <tool>` to install into your AI tool — no `npm install` needed. Or try any skill free at https://mohitagw15856.github.io/pm-claude-skills/",
   "keywords": [
     "claude",
     "claude-code",
@@ -54,6 +54,7 @@
     "workflows.json"
   ],
   "scripts": {
+    "postinstall": "node bin/postinstall.mjs",
     "new-skill": "node scripts/new-skill.mjs",
     "skillcheck": "node scripts/skillcheck.mjs",
     "build:exports": "node scripts/build-exports.mjs",