skillsets 0.9.1 → 0.9.3

package/README.md

@@ -51,7 +51,7 @@ cli/
 | `search.ts` | Fuzzy search by name, description, tags | [Docs](./docs_cli/commands/search.md) |
 | `view.ts` | View a skillset README before installing | [Docs](./docs_cli/commands/view.md) |
 | `install.ts` | Install skillset via degit + MCP/deps warnings + verify checksums | [Docs](./docs_cli/commands/install.md) |
-| `init.ts` | Scaffold new skillset with QUICKSTART.md | [Docs](./docs_cli/commands/init.md) |
+| `init.ts` | Scaffold new skillset with QUICKSTART_<NAME>.md | [Docs](./docs_cli/commands/init.md) |
 | `audit.ts` | Validate skillset + MCP + runtime deps before submission | [Docs](./docs_cli/commands/audit.md) |
 | `audit-report.ts` | Audit report generation utilities | [Docs](./docs_cli/commands/audit-report.md) |
 | `submit.ts` | Open PR to registry | [Docs](./docs_cli/commands/submit.md) |

package/dist/commands/audit.js

@@ -74,17 +74,18 @@ function isBinaryFile(filePath) {
         return false;
     }
 }
-/** Find the README_<NAME>.md file in content/ */
-function findReadme(cwd) {
+/** Find a content file matching <PREFIX>_<NAME>.md pattern */
+function findContentFile(cwd, prefix) {
     const contentDir = join(cwd, 'content');
     if (!existsSync(contentDir))
         return null;
     const entries = readdirSync(contentDir);
-    const readme = entries.find(f => /^README_[^/]+\.md$/i.test(f));
-    return readme ? join(contentDir, readme) : null;
+    const pattern = new RegExp(`^${prefix}_[^/]+\\.md$`, 'i');
+    const match = entries.find(f => pattern.test(f));
+    return match ? join(contentDir, match) : null;
 }
 function scanReadmeLinks(cwd) {
-    const readmePath = findReadme(cwd);
+    const readmePath = findContentFile(cwd, 'README');
     if (!readmePath)
         return [];
     const relativeLinks = [];
@@ -284,9 +285,9 @@ export async function audit(options = {}) {
     // 2. Required files
     spinner.text = 'Checking required files...';
     const hasContent = existsSync(join(cwd, 'content'));
-    const hasReadme = !!findReadme(cwd);
-    const hasQuickstart = existsSync(join(cwd, 'content', 'QUICKSTART.md'));
-    const hasInstallNotes = existsSync(join(cwd, 'content', 'INSTALL_NOTES.md'));
+    const hasReadme = !!findContentFile(cwd, 'README');
+    const hasQuickstart = !!findContentFile(cwd, 'QUICKSTART');
+    const hasInstallNotes = !!findContentFile(cwd, 'INSTALL_NOTES');
     const hasLicense = existsSync(join(cwd, 'content', 'LICENSE'));
     const hasSkillsetYaml = existsSync(join(cwd, 'skillset.yaml'));
     const missingFiles = [];
@@ -297,9 +298,9 @@ export async function audit(options = {}) {
     if (!hasReadme)
         missingFiles.push('content/README_<NAME>.md');
     if (!hasQuickstart)
-        missingFiles.push('content/QUICKSTART.md');
+        missingFiles.push('content/QUICKSTART_<NAME>.md');
     if (!hasInstallNotes)
-        missingFiles.push('content/INSTALL_NOTES.md');
+        missingFiles.push('content/INSTALL_NOTES_<NAME>.md');
     if (!hasLicense)
         missingFiles.push('content/LICENSE');
     if (missingFiles.length === 0) {
@@ -315,7 +316,8 @@ export async function audit(options = {}) {
     // 2b. Install notes validation
     spinner.text = 'Validating install notes...';
     if (hasInstallNotes) {
-        const installNotesContent = readFileSync(join(cwd, 'content', 'INSTALL_NOTES.md'), 'utf-8');
+        const installNotesPath = findContentFile(cwd, 'INSTALL_NOTES');
+        const installNotesContent = readFileSync(installNotesPath, 'utf-8');
         if (installNotesContent.length > 4000) {
             results.installNotes = {
                 status: 'FAIL',

package/dist/commands/init.js

@@ -89,6 +89,7 @@ After installing via \`npx skillsets install {{AUTHOR_HANDLE}}/{{NAME}}\`, custo
 your-project/
 ├── .claude/          # Skills, agents, resources
 ├── CLAUDE.md         # Project config ← START HERE
+├── QUICKSTART_{{NAME}}.md # Post-install guide
 └── README_{{NAME}}.md # Skillset documentation
 \`\`\`
 
@@ -353,8 +354,7 @@ export async function init(options) {
     }
     // Auto-detect existing files — core skillset files and primitives
     const coreFiles = [
-        'CLAUDE.md', 'QUICKSTART.md', 'INSTALL_NOTES.md',
-        '.claude/', '.mcp.json',
+        'CLAUDE.md', '.claude/', '.mcp.json',
     ];
     const detectedCore = coreFiles.filter((f) => {
         const checkPath = f.endsWith('/') ? f.slice(0, -1) : f;
@@ -423,18 +423,20 @@ export async function init(options) {
                 .replace(/\{\{AUTHOR_HANDLE\}\}/g, authorHandle);
             writeFileSync(join(cwd, 'content', readmeFilename), readme);
         }
-        // Generate content/QUICKSTART.md (if not copying existing)
-        if (!existsSync(join(cwd, 'content', 'QUICKSTART.md'))) {
+        // Generate content/QUICKSTART_<NAME>.md (if not already present)
+        const quickstartFilename = `QUICKSTART_${name.toUpperCase()}.md`;
+        if (!existsSync(join(cwd, 'content', quickstartFilename))) {
             const quickstart = QUICKSTART_TEMPLATE
                 .replace(/\{\{NAME\}\}/g, name)
                 .replace(/\{\{AUTHOR_HANDLE\}\}/g, authorHandle);
-            writeFileSync(join(cwd, 'content', 'QUICKSTART.md'), quickstart);
+            writeFileSync(join(cwd, 'content', quickstartFilename), quickstart);
         }
-        // Generate content/INSTALL_NOTES.md (if not copying existing)
-        if (!existsSync(join(cwd, 'content', 'INSTALL_NOTES.md'))) {
+        // Generate content/INSTALL_NOTES_<NAME>.md (if not already present)
+        const installNotesFilename = `INSTALL_NOTES_${name.toUpperCase()}.md`;
+        if (!existsSync(join(cwd, 'content', installNotesFilename))) {
             const installNotes = INSTALL_NOTES_TEMPLATE
                 .replace(/\{\{NAME\}\}/g, name);
-            writeFileSync(join(cwd, 'content', 'INSTALL_NOTES.md'), installNotes);
+            writeFileSync(join(cwd, 'content', installNotesFilename), installNotes);
         }
         // Generate empty content/LICENSE (if not copying existing)
         if (!existsSync(join(cwd, 'content', 'LICENSE'))) {
@@ -446,8 +448,8 @@ export async function init(options) {
         console.log('  skillset.yaml     - Manifest (edit as needed)');
         console.log('  content/          - Installable files');
         console.log(`    ├── ${readmeFilename} - Documentation`);
-        console.log('    ├── QUICKSTART.md   - Post-install guide');
-        console.log('    ├── INSTALL_NOTES.md - Pre-install notes');
+        console.log(`    ├── ${quickstartFilename} - Post-install guide`);
+        console.log(`    ├── ${installNotesFilename} - Pre-install notes`);
         console.log('    ├── LICENSE         - License (populate before audit)');
         if (filesToCopy.length > 0) {
             filesToCopy.forEach((f) => console.log(`    └── ${f}`));
@@ -456,7 +458,7 @@ export async function init(options) {
             console.log('    └── (add your .claude/ and/or CLAUDE.md here)');
         }
         console.log(chalk.cyan('\nNext steps:'));
-        console.log('  1. Edit content/INSTALL_NOTES.md with install notes');
+        console.log(`  1. Edit content/${installNotesFilename} with install notes`);
         console.log('  2. Ensure content/ has your skillset files');
         console.log('  3. Run: npx skillsets audit');
         console.log('  4. Run: /audit-skill [AUDIT_REPORT.md] [path/to/reference-repo]');

package/dist/commands/install.js

@@ -145,6 +145,12 @@ export async function install(skillsetId, options) {
             await rm(tempDir, { recursive: true, force: true });
             throw new Error('Checksum verification failed - files may be corrupted');
         }
+        // Strip redirect README.md if a README_*.md exists (avoid clobbering user's README)
+        const tempEntries = await readdir(tempDir);
+        const hasNamedReadme = tempEntries.some(f => /^README_[^/]+\.md$/i.test(f));
+        if (hasNamedReadme && tempEntries.includes('README.md')) {
+            await rm(join(tempDir, 'README.md'));
+        }
         // Checksums valid — move verified content to cwd
         spinner.text = 'Installing verified content...';
         const entries = await readdir(tempDir, { withFileTypes: true });
@@ -171,6 +177,7 @@ export async function install(skillsetId, options) {
     console.log(chalk.green('\n✓ Installation complete!'));
     console.log(chalk.gray('\nNext steps:'));
     console.log('  1. Ask Opus to verify the skillset matches its claims');
-    console.log('  2. Read QUICKSTART.md to customize for your project');
+    const skillsetName = skillsetId.split('/')[1];
+    console.log(`  2. Read QUICKSTART_${skillsetName.toUpperCase()}.md to customize for your project`);
     console.log('  3. Run: claude');
 }

package/dist/commands/submit.js

@@ -235,7 +235,7 @@ Submitted via \`npx skillsets submit\`
 
 - [x] \`skillset.yaml\` validated against schema
 - [x] \`README_${skillset.name.toUpperCase()}.md\` with installation and usage instructions
-- [x] \`content/INSTALL_NOTES.md\` with install notes
+- [x] \`content/INSTALL_NOTES_${skillset.name.toUpperCase()}.md\` with install notes
 - [x] \`content/LICENSE\` populated
 - [x] \`AUDIT_REPORT.md\` generated and passing
 - [x] \`content/\` directory with skillset files

package/dist/lib/templates.d.ts

@@ -1,4 +1,4 @@
 export declare const SKILLSET_YAML_TEMPLATE = "schema_version: \"1.0\"\nbatch_id: \"{{BATCH_ID}}\"\n\n# Identity\nname: \"{{NAME}}\"\nversion: \"1.0.0\"\ndescription: \"{{DESCRIPTION}}\"\n\nauthor:\n  handle: \"{{AUTHOR_HANDLE}}\"\n  url: \"{{AUTHOR_URL}}\"\n\n# Verification\nverification:\n  production_links:\n    - url: \"{{PRODUCTION_URL}}\"\n  audit_report: \"./AUDIT_REPORT.md\"\n\n# Discovery\ntags:\n{{TAGS}}\n\ncompatibility:\n  claude_code_version: \">=1.0.0\"\n  languages:\n    - \"any\"\n\n# Lifecycle\nstatus: \"active\"\n\n# Content\nentry_point: \"./content/CLAUDE.md\"\n";
 export declare const README_TEMPLATE = "# {{NAME}}\n\n{{DESCRIPTION}}\n\n## Installation\n\n```bash\nnpx skillsets install {{AUTHOR_HANDLE}}/{{NAME}}\n```\n\n## Usage\n\n[Describe how to use your skillset]\n\n## What's Included\n\n[List the key files and their purposes]\n\n";
-export declare const QUICKSTART_TEMPLATE = "# Quickstart\n\nAfter installing via `npx skillsets install {{AUTHOR_HANDLE}}/{{NAME}}`, customize the workflow for your project.\n\n---\n\n## What Was Installed\n\n```\nyour-project/\n\u251C\u2500\u2500 .claude/          # Skills, agents, resources\n\u251C\u2500\u2500 CLAUDE.md         # Project config \u2190 START HERE\n\u2514\u2500\u2500 README_{{NAME}}.md # Skillset documentation\n```\n\n---\n\n## Getting Started\n\n1. **Edit CLAUDE.md** \u2014 Replace placeholder content with your project's specifics\n2. **Customize .claude/** \u2014 Adapt skills, agents, and resources for your stack\n3. **Run** \u2014 `claude` to start using the skillset\n\n---\n\n## Customization Checklist\n\n- [ ] Update Identity & Constraints in CLAUDE.md\n- [ ] Configure style guides in .claude/resources/\n- [ ] Adapt agent definitions in .claude/agents/\n- [ ] Set up any required infrastructure (Docker, API keys, etc.)\n\n---\n\n## Resources\n\n[Add links to documentation, examples, or support channels]\n";
+export declare const QUICKSTART_TEMPLATE = "# Quickstart\n\nAfter installing via `npx skillsets install {{AUTHOR_HANDLE}}/{{NAME}}`, customize the workflow for your project.\n\n---\n\n## What Was Installed\n\n```\nyour-project/\n\u251C\u2500\u2500 .claude/          # Skills, agents, resources\n\u251C\u2500\u2500 CLAUDE.md         # Project config \u2190 START HERE\n\u251C\u2500\u2500 QUICKSTART_{{NAME}}.md # Post-install guide\n\u2514\u2500\u2500 README_{{NAME}}.md # Skillset documentation\n```\n\n---\n\n## Getting Started\n\n1. **Edit CLAUDE.md** \u2014 Replace placeholder content with your project's specifics\n2. **Customize .claude/** \u2014 Adapt skills, agents, and resources for your stack\n3. **Run** \u2014 `claude` to start using the skillset\n\n---\n\n## Customization Checklist\n\n- [ ] Update Identity & Constraints in CLAUDE.md\n- [ ] Configure style guides in .claude/resources/\n- [ ] Adapt agent definitions in .claude/agents/\n- [ ] Set up any required infrastructure (Docker, API keys, etc.)\n\n---\n\n## Resources\n\n[Add links to documentation, examples, or support channels]\n";
 export declare const INSTALL_NOTES_TEMPLATE = "# {{NAME}}\n\n<!--\nInstall notes for pre-install display. Max 4000 characters total.\nWhat does this skillset do? What should users know before installing?\nThe dependency section below is populated by /audit-skill during review.\n-->\n\n## Dependencies\n\n<!-- Populated automatically by /audit-skill -->\n";

package/dist/lib/templates.js

@@ -62,6 +62,7 @@ After installing via \`npx skillsets install {{AUTHOR_HANDLE}}/{{NAME}}\`, custo
 your-project/
 ├── .claude/          # Skills, agents, resources
 ├── CLAUDE.md         # Project config ← START HERE
+├── QUICKSTART_{{NAME}}.md # Post-install guide
 └── README_{{NAME}}.md # Skillset documentation
 \`\`\`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillsets",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "CLI tool for discovering and installing verified skillsets",
   "type": "module",
   "bin": {