skillsets 0.8.0 → 0.9.1

package/dist/commands/audit-report.d.ts

@@ -16,6 +16,7 @@ export interface AuditResults {
     mcpServers: AuditResult;
     runtimeDeps: AuditResult;
     installNotes: AuditResult;
+    license: AuditResult;
     ccExtensions: AuditResult;
     skillsetName?: string;
     skillsetVersion?: string;

package/dist/commands/audit-report.js

@@ -17,6 +17,7 @@ export function isAuditPassing(results, enforceMcp) {
         (enforceMcp ? results.mcpServers.status === 'PASS' : true) &&
         (enforceMcp ? results.runtimeDeps.status === 'PASS' : true) &&
         results.installNotes.status === 'PASS' &&
+        results.license.status === 'PASS' &&
         (enforceMcp ? results.ccExtensions.status === 'PASS' : true);
 }
 function statusIcon(status) {
@@ -38,7 +39,7 @@ export function hasWarnings(results) {
         results.manifest, results.requiredFiles, results.contentStructure,
         results.fileSize, results.binary, results.secrets, results.readmeLinks,
         results.versionCheck, results.mcpServers, results.runtimeDeps,
-        results.installNotes, results.ccExtensions,
+        results.installNotes, results.license, results.ccExtensions,
     ];
     return checks.some(c => c.status === 'WARNING');
 }
@@ -73,6 +74,7 @@ export function generateReport(results, enforceMcp = false) {
 | MCP Servers | ${statusIcon(results.mcpServers.status)} | ${results.mcpServers.details} |
 | Runtime Dependencies | ${statusIcon(results.runtimeDeps.status)} | ${results.runtimeDeps.details} |
 | Install Notes | ${statusIcon(results.installNotes.status)} | ${results.installNotes.details} |
+| License | ${statusIcon(results.license.status)} | ${results.license.details} |
 | CC Extensions | ${statusIcon(results.ccExtensions.status)} | ${results.ccExtensions.details} |
 
 ---
@@ -130,7 +132,11 @@ ${results.runtimeDeps.findings || 'Runtime dependency declarations are consisten
 
 ${results.installNotes.findings || 'Install notes present and valid.'}
 
-### 11. CC Extensions
+### 11. License
+
+${results.license.findings || 'License file present and populated.'}
+
+### 12. CC Extensions
 
 ${results.ccExtensions.findings || 'CC extension declarations are consistent with manifest.'}
 

package/dist/commands/audit.js

@@ -52,12 +52,16 @@ function getAllFiles(dir, baseDir = dir) {
     }
     return files;
 }
+const TEXT_BASENAMES = new Set(['LICENSE', 'LICENCE', 'Makefile', 'Dockerfile', 'Gemfile']);
 function isBinaryFile(filePath) {
     const ext = filePath.substring(filePath.lastIndexOf('.')).toLowerCase();
     if (TEXT_EXTENSIONS.has(ext))
         return false;
     if (filePath.endsWith('.example'))
         return false;
+    const basename = filePath.substring(filePath.lastIndexOf('/') + 1);
+    if (TEXT_BASENAMES.has(basename))
+        return false;
     // Check for null bytes in first 512 bytes
     try {
         const buffer = Buffer.alloc(512);
@@ -70,9 +74,18 @@ function isBinaryFile(filePath) {
         return false;
     }
 }
+/** Find the README_<NAME>.md file in content/ */
+function findReadme(cwd) {
+    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;
+}
 function scanReadmeLinks(cwd) {
-    const readmePath = join(cwd, 'content', 'README.md');
-    if (!existsSync(readmePath))
+    const readmePath = findReadme(cwd);
+    if (!readmePath)
         return [];
     const relativeLinks = [];
     const content = readFileSync(readmePath, 'utf-8');
@@ -243,6 +256,7 @@ export async function audit(options = {}) {
         mcpServers: { status: 'PASS', details: '' },
         runtimeDeps: { status: 'PASS', details: '' },
         installNotes: { status: 'PASS', details: '' },
+        license: { status: 'PASS', details: '' },
         ccExtensions: { status: 'PASS', details: '' },
         isUpdate: false,
         files: [],
@@ -270,9 +284,10 @@ export async function audit(options = {}) {
     // 2. Required files
     spinner.text = 'Checking required files...';
     const hasContent = existsSync(join(cwd, 'content'));
-    const hasReadme = existsSync(join(cwd, 'content', 'README.md'));
+    const hasReadme = !!findReadme(cwd);
     const hasQuickstart = existsSync(join(cwd, 'content', 'QUICKSTART.md'));
     const hasInstallNotes = existsSync(join(cwd, 'content', 'INSTALL_NOTES.md'));
+    const hasLicense = existsSync(join(cwd, 'content', 'LICENSE'));
     const hasSkillsetYaml = existsSync(join(cwd, 'skillset.yaml'));
     const missingFiles = [];
     if (!hasSkillsetYaml)
@@ -280,11 +295,13 @@ export async function audit(options = {}) {
     if (!hasContent)
         missingFiles.push('content/');
     if (!hasReadme)
-        missingFiles.push('content/README.md');
+        missingFiles.push('content/README_<NAME>.md');
     if (!hasQuickstart)
         missingFiles.push('content/QUICKSTART.md');
     if (!hasInstallNotes)
         missingFiles.push('content/INSTALL_NOTES.md');
+    if (!hasLicense)
+        missingFiles.push('content/LICENSE');
     if (missingFiles.length === 0) {
         results.requiredFiles = { status: 'PASS', details: 'All present' };
     }
@@ -320,6 +337,24 @@ export async function audit(options = {}) {
     else {
         results.installNotes = { status: 'FAIL', details: 'Missing' };
     }
+    // 2c. License validation
+    spinner.text = 'Validating license...';
+    if (hasLicense) {
+        const licenseContent = readFileSync(join(cwd, 'content', 'LICENSE'), 'utf-8').trim();
+        if (licenseContent.length === 0) {
+            results.license = {
+                status: 'FAIL',
+                details: 'Empty LICENSE file',
+                findings: 'content/LICENSE must contain a valid license. Populate it before submitting.',
+            };
+        }
+        else {
+            results.license = { status: 'PASS', details: 'Valid' };
+        }
+    }
+    else {
+        results.license = { status: 'FAIL', details: 'Missing' };
+    }
     // 3. Content structure
     spinner.text = 'Verifying content structure...';
     const hasClaudeDir = existsSync(join(cwd, 'content', '.claude'));
@@ -467,6 +502,7 @@ export async function audit(options = {}) {
         [results.mcpServers, 'MCP Servers'],
         [results.runtimeDeps, 'Runtime Deps'],
         [results.installNotes, 'Install Notes'],
+        [results.license, 'License'],
         [results.ccExtensions, 'CC Extensions'],
     ];
     console.log('\n' + chalk.bold('Audit Summary:'));

package/dist/commands/init.js

@@ -76,9 +76,6 @@ npx skillsets install {{AUTHOR_HANDLE}}/{{NAME}}
 
 [List the key files and their purposes]
 
-## License
-
-[Your license]
 `;
 const QUICKSTART_TEMPLATE = `# Quickstart
 
@@ -92,7 +89,7 @@ After installing via \`npx skillsets install {{AUTHOR_HANDLE}}/{{NAME}}\`, custo
 your-project/
 ├── .claude/          # Skills, agents, resources
 ├── CLAUDE.md         # Project config ← START HERE
-└── README.md         # Documentation
+└── README_{{NAME}}.md # Skillset documentation
 \`\`\`
 
 ---
@@ -356,7 +353,7 @@ export async function init(options) {
     }
     // Auto-detect existing files — core skillset files and primitives
     const coreFiles = [
-        'CLAUDE.md', 'README.md', 'QUICKSTART.md', 'INSTALL_NOTES.md',
+        'CLAUDE.md', 'QUICKSTART.md', 'INSTALL_NOTES.md',
         '.claude/', '.mcp.json',
     ];
     const detectedCore = coreFiles.filter((f) => {
@@ -416,13 +413,15 @@ export async function init(options) {
             .replace('{{PRODUCTION_URL}}', productionUrl)
             .replace('{{TAGS}}', tagsYaml);
         writeFileSync(join(cwd, 'skillset.yaml'), skillsetYaml);
-        // Generate content/README.md (if not copying existing)
-        if (!existsSync(join(cwd, 'content', 'README.md'))) {
+        // Generate content/README_<NAME>.md (if not copying existing)
+        // Named README avoids clobbering the user's own README.md on install
+        const readmeFilename = `README_${name.toUpperCase()}.md`;
+        if (!existsSync(join(cwd, 'content', readmeFilename))) {
             const readme = README_TEMPLATE
                 .replace(/\{\{NAME\}\}/g, name)
                 .replace(/\{\{DESCRIPTION\}\}/g, description)
                 .replace(/\{\{AUTHOR_HANDLE\}\}/g, authorHandle);
-            writeFileSync(join(cwd, 'content', 'README.md'), readme);
+            writeFileSync(join(cwd, 'content', readmeFilename), readme);
         }
         // Generate content/QUICKSTART.md (if not copying existing)
         if (!existsSync(join(cwd, 'content', 'QUICKSTART.md'))) {
@@ -437,14 +436,19 @@ export async function init(options) {
                 .replace(/\{\{NAME\}\}/g, name);
             writeFileSync(join(cwd, 'content', 'INSTALL_NOTES.md'), installNotes);
         }
+        // Generate empty content/LICENSE (if not copying existing)
+        if (!existsSync(join(cwd, 'content', 'LICENSE'))) {
+            writeFileSync(join(cwd, 'content', 'LICENSE'), '');
+        }
         spinner.succeed('Skillset structure created');
         // Summary
         console.log(chalk.green('\n✓ Initialized skillset submission:\n'));
         console.log('  skillset.yaml     - Manifest (edit as needed)');
         console.log('  content/          - Installable files');
-        console.log('    ├── README.md       - Documentation');
+        console.log(`    ├── ${readmeFilename} - Documentation`);
         console.log('    ├── QUICKSTART.md   - Post-install guide');
         console.log('    ├── INSTALL_NOTES.md - Pre-install notes');
+        console.log('    ├── LICENSE         - License (populate before audit)');
         if (filesToCopy.length > 0) {
             filesToCopy.forEach((f) => console.log(`    └── ${f}`));
         }

package/dist/commands/submit.js

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

package/dist/commands/view.js

@@ -14,7 +14,12 @@ export async function view(skillsetId) {
     }
     const [namespace, name] = skillsetId.split('/');
     const encodedPath = encodeURIComponent(namespace) + '/' + encodeURIComponent(name);
-    const readmeUrl = `${GITHUB_RAW_BASE}/skillsets/${encodedPath}/content/README.md`;
+    const readmeFile = metadata.files
+        ? Object.keys(metadata.files).find(f => /^content\/README_[^/]+\.md$/i.test(f))
+        : null;
+    const readmeUrl = readmeFile
+        ? `${GITHUB_RAW_BASE}/skillsets/${encodedPath}/${readmeFile}`
+        : `${GITHUB_RAW_BASE}/skillsets/${encodedPath}/content/README.md`;
     const auditUrl = `${GITHUB_RAW_BASE}/skillsets/${encodedPath}/AUDIT_REPORT.md`;
     const [readmeResponse, auditResponse] = await Promise.all([
         fetch(readmeUrl),

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## License\n\n[Your license]\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.md         # 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 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 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

@@ -49,9 +49,6 @@ npx skillsets install {{AUTHOR_HANDLE}}/{{NAME}}
 
 [List the key files and their purposes]
 
-## License
-
-[Your license]
 `;
 export const QUICKSTART_TEMPLATE = `# Quickstart
 
@@ -65,7 +62,7 @@ After installing via \`npx skillsets install {{AUTHOR_HANDLE}}/{{NAME}}\`, custo
 your-project/
 ├── .claude/          # Skills, agents, resources
 ├── CLAUDE.md         # Project config ← START HERE
-└── README.md         # Documentation
+└── README_{{NAME}}.md # Skillset documentation
 \`\`\`
 
 ---

package/package.json

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