@olegkoval/agent-skills 1.9.2 → 1.10.1

package/packages/software-development/semantic-release-beta/adapters/cursor/skills/semantic-release-beta/SKILL.md

@@ -1,5 +1,3 @@
-<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
-
 ---
 name: semantic-release-beta
 description: Set up or update a Node.js release pipeline that uses semantic-release-npm-github-publish with a stable main channel and a prerelease beta channel on a beta branch, including GitHub Actions validation and npm publishing behavior.
@@ -17,6 +15,7 @@ metadata:
     - github-actions
     - npm
 ---
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
 
 # semantic-release-beta
 

package/packages/software-development/semantic-release-beta/adapters/kiro/steering/semantic-release-beta.md

@@ -5,7 +5,6 @@ inclusion: manual
 description: "Set up semantic-release-npm-github-publish with stable main releases and prerelease beta releases on a beta branch."
 ---
 
-
 # semantic-release-beta
 
 Use this skill when a project needs a reusable beta prerelease workflow with:

package/packages/software-development/semantic-release-beta/adapters/windsurf/rules/semantic-release-beta.md

@@ -4,7 +4,6 @@
 description: "Set up semantic-release-npm-github-publish with stable main releases and prerelease beta releases on a beta branch."
 ---
 
-
 # semantic-release-beta
 
 Use this skill when a project needs a reusable beta prerelease workflow with:

package/packages/software-development/starter-rules/adapters/claude/skills/starter-rules/SKILL.md

@@ -1,5 +1,3 @@
-<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
-
 ---
 name: starter-rules
 description: Load and enforce the hard rules every oleg-koval/* starter must obey. Use when starting or auditing work in saas-init, ts-npm-starter, go-starter, py-starter, or any future oleg-koval template repo. Covers functional style, 300-line file cap, E2E > unit tests, pre-commit hooks, no-comment policy, KISS/DRY/SOLID, and Vertical Slice as default architecture for SaaS/app starters.
@@ -7,7 +5,7 @@ license: MIT
 allowed-tools: Read, Bash
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools.
 metadata:
-  targets: ["claude"]
+  targets: [_source-only]
   author: Oleg Koval
   tags:
     - starters
@@ -17,6 +15,7 @@ metadata:
     - linting
     - pre-commit
 ---
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
 
 # Starter Rules
 

package/packages/software-development/starter-rules/adapters/cursor/skills/starter-rules/SKILL.md

@@ -1,5 +1,3 @@
-<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
-
 ---
 name: starter-rules
 description: Load and enforce the hard rules every oleg-koval/* starter must obey. Use when starting or auditing work in saas-init, ts-npm-starter, go-starter, py-starter, or any future oleg-koval template repo. Covers functional style, 300-line file cap, E2E > unit tests, pre-commit hooks, no-comment policy, KISS/DRY/SOLID, and Vertical Slice as default architecture for SaaS/app starters.
@@ -17,6 +15,7 @@ metadata:
     - linting
     - pre-commit
 ---
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
 
 # Starter Rules
 

package/packages/software-development/starter-rules/adapters/kiro/steering/starter-rules.md

@@ -5,7 +5,6 @@ inclusion: manual
 description: "Load and enforce hard rules for every oleg-koval/* starter: 300-line files, E2E tests, pre-commit hooks, Vertical Slice architecture, no comments, KISS/DRY/SOLID."
 ---
 
-
 # Starter Rules
 
 ## Overview

package/packages/software-development/starter-rules/adapters/windsurf/rules/starter-rules.md

@@ -4,7 +4,6 @@
 description: "Load and enforce hard rules for every oleg-koval/* starter: 300-line files, E2E tests, pre-commit hooks, Vertical Slice architecture, no comments, KISS/DRY/SOLID."
 ---
 
-
 # Starter Rules
 
 ## Overview

package/scripts/build-adapters.sh

@@ -16,6 +16,11 @@ const skillPathFor = (pkg) => path.join(root, pkg.path, 'SKILL.md')
 const promptNameFor = (pkg) => `${pkg.name}.prompt.md`
 const generatedHeader = '<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->'
 const stripFrontmatter = (content) => content.replace(/^---\n[\s\S]*?\n---\n?/, '')
+const extractFrontmatter = (content) => {
+  const m = content.match(/^(---\n[\s\S]*?\n---\n?)/)
+  if (!m) return ''
+  return m[1].endsWith('\n') ? m[1] : m[1] + '\n'
+}
 const injectTargets = (content, targets) => {
   const targetsYaml = targets.length > 0
     ? `  targets: [${targets.map(t => JSON.stringify(t)).join(', ')}]`
@@ -193,6 +198,9 @@ for (const pkg of catalog.packages) {
 
 for (const pkg of catalog.packages) {
   const canonical = fs.readFileSync(skillPathFor(pkg), 'utf8').trimEnd()
+  const fm = extractFrontmatter(canonical)
+  if (!fm) throw new Error(`canonical SKILL.md has no frontmatter: ${skillPathFor(pkg)}`)
+  const body = stripTrailingLineWhitespace(stripFrontmatter(canonical).trimStart().trimEnd())
 
   if (pkg.adapters.includes('claude')) {
     const claudeDestDir = path.join(root, pkg.path, 'adapters', 'claude', 'skills', pkg.name)
@@ -209,7 +217,7 @@ for (const pkg of catalog.packages) {
         2,
       ) + '\n',
     )
-    fs.writeFileSync(path.join(claudeDestDir, 'SKILL.md'), [generatedHeader, '', injectTargets(canonical, ['claude']), ''].join('\n'))
+    fs.writeFileSync(path.join(claudeDestDir, 'SKILL.md'), [fm + generatedHeader, '', body, ''].join('\n'))
     copySkillResources(pkg, claudeDestDir)
   }
 
@@ -230,12 +238,15 @@ for (const pkg of catalog.packages) {
         2,
       ) + '\n',
     )
-    fs.writeFileSync(path.join(destDir, 'SKILL.md'), [generatedHeader, '', injectTargets(canonical, ['cursor']), ''].join('\n'))
+    const cursorCanonical = injectTargets(canonical, ['cursor'])
+    const cursorFrontmatter = extractFrontmatter(cursorCanonical)
+    const cursorBody = stripTrailingLineWhitespace(stripFrontmatter(cursorCanonical).trimStart().trimEnd())
+    fs.writeFileSync(path.join(destDir, 'SKILL.md'), [cursorFrontmatter + generatedHeader, '', cursorBody, ''].join('\n'))
     copySkillResources(pkg, destDir)
   }
 
   if (pkg.adapters.includes('windsurf')) {
-    const skillBody = stripFrontmatter(canonical).trimEnd()
+    const skillBody = stripFrontmatter(canonical).trimStart().trimEnd()
     const content = stripTrailingLineWhitespace([
       generatedHeader,
       '',
@@ -252,7 +263,7 @@ for (const pkg of catalog.packages) {
   }
 
   if (pkg.adapters.includes('kiro')) {
-    const skillBody = stripFrontmatter(canonical).trimEnd()
+    const skillBody = stripFrontmatter(canonical).trimStart().trimEnd()
     const content = stripTrailingLineWhitespace([
       generatedHeader,
       '',

package/scripts/validate-catalog.sh

@@ -118,6 +118,22 @@ for (const pkg of catalog.packages) {
     throw new Error(`stale flat package path exists: ${oldFlatPath}`)
   }
 }
+
+// Assert every SKILL.md (canonical + adapter wrappers) has a valid closed frontmatter block
+// Codex adapter files use README.md and are validated separately above
+const walk = (dir) => {
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name)
+    if (entry.isDirectory()) walk(full)
+    else if (entry.name === 'SKILL.md') {
+      const content = fs.readFileSync(full, 'utf8')
+      if (!content.match(/^---\n[\s\S]*?\n---\n?/)) {
+        throw new Error(`SKILL.md does not have valid closed frontmatter: ${full}`)
+      }
+    }
+  }
+}
+walk('packages')
 EOF
 
 echo "catalog validation passed"