@codepassion/skills 1.0.0

package/SKILLS.md

@@ -0,0 +1,19 @@
+# C9N Agent Skills
+
+Agent skills (SKILL.md) based on the CodePassion (C9N) conventions.
+
+## Install
+
+    npx @codepassion/c9n-skills install claude     # ~/.claude/skills
+    npx @codepassion/c9n-skills install codex      # ~/.codex/skills
+    npx @codepassion/c9n-skills install project    # ./.agents/skills
+    npx @codepassion/c9n-skills install combined   # one combined skill
+
+Or: ./install.sh {claude|codex|project|combined}
+
+## Edit
+
+Per-topic SKILL.md files in skills/c9n-* are the source of truth.
+skills/c9n/SKILL.md is auto-generated — run npm run build.
+npm test validates frontmatter against schemas/skill.schema.json.
+CI runs the same on every push and PR.

package/bin/c9n-skills.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { cp, mkdir, readdir, stat } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+const SRC = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'skills')
+const [,, cmd='install', target='claude', ...rest] = process.argv
+if (cmd==='help'||cmd==='--help'||cmd==='-h'){ help(); process.exit(0) }
+if (cmd!=='install'){ help(); process.exit(1) }
+const flags={dest:null,force:false,dryRun:false}
+for (let i=0;i<rest.length;i++){ const a=rest[i]
+  if (a==='--force') flags.force=true
+  else if (a==='--dry-run') flags.dryRun=true
+  else if (a==='--dest') flags.dest=resolve(rest[++i]??'') }
+const dest = flags.dest ?? defaultDest(target)
+if (!dest){ help(); process.exit(1) }
+const sources = await resolveSources(target)
+if (!sources.length){ console.error('No skills found'); process.exit(1) }
+console.log(`Installing ${sources.length} skill(s) into ${dest}${flags.dryRun?' (dry-run)':''}`)
+if (!flags.dryRun) await mkdir(dest,{recursive:true})
+for (const src of sources){ const n=src.split(/[\\/]/).pop(); const t=join(dest,n)
+  if (existsSync(t) && !flags.force){ console.log(`  skip  ${n}`); continue }
+  console.log(`  copy  ${n}`); if (!flags.dryRun) await cp(src,t,{recursive:true,force:true}) }
+console.log('Done.')
+async function resolveSources(t){
+  if (t==='combined'){ const c=join(SRC,'c9n'); return existsSync(c)?[c]:[] }
+  const out=[]; for (const e of await readdir(SRC)){ if (!e.startsWith('c9n-')) continue
+    const f=join(SRC,e); if ((await stat(f)).isDirectory()) out.push(f) }
+  return out }
+function defaultDest(t){ const h=homedir()
+  if (t==='claude'||t==='combined') return join(h,'.claude','skills')
+  if (t==='codex') return join(h,'.codex','skills')
+  if (t==='project') return join(process.cwd(),'.agents','skills')
+  return null }
+function help(){ console.log('c9n-skills install [claude|codex|project|combined] [--dest <dir>] [--force] [--dry-run]') }

package/install.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+set -euo pipefail
+SRC="$(cd "$(dirname "$0")" && pwd)/skills"
+MODE="${1:-claude}"
+case "$MODE" in
+  claude)   DEST="${TARGET_DIR:-$HOME/.claude/skills}" ;;
+  codex)    DEST="${TARGET_DIR:-$HOME/.codex/skills}" ;;
+  project)  DEST="${TARGET_DIR:-$PWD/.agents/skills}" ;;
+  combined) DEST="${TARGET_DIR:-$HOME/.claude/skills}" ;;
+  *) echo "Use: claude | codex | project | combined"; exit 1 ;;
+esac
+mkdir -p "$DEST"
+if [ "$MODE" = "combined" ]; then cp -R "$SRC/c9n" "$DEST/"
+else for d in "$SRC"/c9n-*; do [ -d "$d" ] && cp -R "$d" "$DEST/"; done; fi
+echo "Installed into $DEST"

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@codepassion/skills",
+  "version": "1.0.0",
+  "description": "Agent skills (SKILL.md) for CodePassion (C9N) engineering conventions.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "c9n-skills": "bin/c9n-skills.js"
+  },
+  "files": [
+    "bin",
+    "scripts",
+    "schemas",
+    "skills",
+    "install.sh",
+    "LICENSE",
+    "SKILLS.md"
+  ],
+  "scripts": {
+    "build": "node scripts/build-combined.mjs",
+    "lint": "node scripts/lint-skills.mjs",
+    "test": "npm run build && npm run lint",
+    "prepack": "npm run build && npm run lint",
+    "prepare": "husky || true"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.0.0",
+    "@commitlint/config-conventional": "^19.0.0",
+    "husky": "^9.0.0"
+  },
+  "keywords": [
+    "claude",
+    "codex",
+    "agent",
+    "skills",
+    "skill.md",
+    "codepassion",
+    "c9n",
+    "conventional-commits",
+    "semver",
+    "json-api",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codepassion-team/c9n.git"
+  },
+  "homepage": "https://github.com/codepassion-team/c9n#readme",
+  "bugs": {
+    "url": "https://github.com/codepassion-team/c9n/issues"
+  }
+}

package/schemas/skill.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codepassion.co/schemas/skill.schema.json",
+  "title": "SKILL.md frontmatter",
+  "type": "object",
+  "required": ["name", "description"],
+  "additionalProperties": true,
+  "properties": {
+    "name": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "minLength": 2, "maxLength": 64 },
+    "description": { "type": "string", "minLength": 20, "maxLength": 2000 },
+    "version": { "type": "string", "pattern": "^v?\\d+\\.\\d+\\.\\d+(-[A-Za-z0-9.-]+)?(\\+[A-Za-z0-9.-]+)?$" },
+    "tags": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 32 }, "uniqueItems": true, "maxItems": 20 },
+    "homepage": { "type": "string", "format": "uri" },
+    "license": { "type": "string" }
+  }
+}

package/scripts/build-combined.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { mkdir, readFile, readdir, stat, writeFile } from 'node:fs/promises'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const SKILLS = join(ROOT, 'skills')
+const OUT = join(SKILLS, 'c9n', 'SKILL.md')
+const HDR = `---
+name: c9n
+description: CodePassion (C9N) engineering conventions — a single skill
+  covering workflow, branching, commits, PRs, code review, Clean Code TS,
+  ESLint, formatting, JSON:API, Go/No Go, and SemVer 2.0.0.
+version: 1.0.0
+tags: [c9n, codepassion, conventions]
+homepage: https://github.com/codepassion-team/c9n
+license: MIT
+---
+<!-- AUTO-GENERATED. Edit skills/c9n-*/SKILL.md, then: npm run build -->
+# C9N — CodePassion Engineering Conventions (combined)
+`
+const ORDER = ['c9n-development-workflow','c9n-git-branching','c9n-commit-messages','c9n-pull-requests','c9n-code-review','c9n-clean-code-typescript','c9n-typescript-eslint','c9n-code-formatting','c9n-jsonapi','c9n-go-no-go-release','c9n-semver-deployment']
+const out = [HDR]
+const all = (await readdir(SKILLS)).filter((n) => n.startsWith('c9n-'))
+const list = [...ORDER, ...all.filter((n) => !ORDER.includes(n)).sort()]
+for (const n of list) {
+  const f = join(SKILLS, n, 'SKILL.md')
+  try { if (!(await stat(f)).isFile()) continue } catch { continue }
+  const t = await readFile(f, 'utf8')
+  const i = t.indexOf('\n---', 3)
+  const body = i === -1 ? t : t.slice(i + 4).replace(/^\r?\n/, '')
+  const title = n.replace(/^c9n-/, '').split('-').map((w) => w[0].toUpperCase() + w.slice(1)).join(' ')
+  out.push(`\n---\n\n## ${title}\n\n${body.replace(/^#\s+/gm, '## ').trimStart()}\n`)
+}
+await mkdir(dirname(OUT), { recursive: true })
+await writeFile(OUT, out.join('\n'), 'utf8')
+console.log('Wrote', OUT)

package/scripts/lint-skills.mjs

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { readFile, readdir, stat } from 'node:fs/promises'
+import { dirname, join, relative, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const SCHEMA = JSON.parse(await readFile(join(ROOT, 'schemas/skill.schema.json'), 'utf8'))
+const files = []; const fails = []
+async function collect(d){ let es; try{es=await readdir(d)}catch{return}
+  for (const e of es){ const f=join(d,e); const s=await stat(f)
+    if (s.isDirectory()) await collect(f); else if (e==='SKILL.md') files.push(f) } }
+await collect(join(ROOT,'skills'))
+for (const f of files){
+  const rel=relative(process.cwd(),f); const t=await readFile(f,'utf8')
+  if (!t.startsWith('---')){ fails.push([rel,'missing frontmatter']); continue }
+  const end=t.indexOf('\n---',3); if (end===-1){ fails.push([rel,'unterminated frontmatter']); continue }
+  const meta=parse(t.slice(3,end))
+  for (const e of validate(meta,SCHEMA,'')) fails.push([rel,e])
+}
+if (fails.length){ for (const [f,m] of fails) console.error(`✗ ${f}: ${m}`); process.exit(1) }
+console.log(`✓ ${files.length} SKILL.md passed`)
+function parse(src){ const o={}; let k=null
+  for (const r of src.split(/\r?\n/)){ const l=r.replace(/\s+$/,''); if(!l) continue
+    const m=l.match(/^([A-Za-z_][\w-]*):\s?(.*)$/)
+    if (m && !l.startsWith(' ')){ k=m[1]; const v=(m[2]??'').trim()
+      o[k]=v.startsWith('[')&&v.endsWith(']') ? v.slice(1,-1).split(',').map(s=>s.trim().replace(/^['"]|['"]$/g,'')).filter(Boolean) : v.replace(/^['"]|['"]$/g,'')
+    } else if (k && /^\s+\S/.test(r) && typeof o[k]==='string'){ o[k]=`${o[k]} ${r.trim()}`.trim() } }
+  return o }
+function validate(v,s,p){ const e=[]
+  if (s.type==='object'){ for (const r of s.required??[]) if (v?.[r]===undefined||v?.[r]==='') e.push(`missing required: ${r}`)
+    for (const [k,sub] of Object.entries(s.properties??{})) if (v?.[k]!==undefined) e.push(...validate(v[k],sub,p?`${p}.${k}`:k)) }
+  if (s.type==='string' && typeof v==='string'){
+    if (s.minLength!==undefined && v.length<s.minLength) e.push(`${p} too short`)
+    if (s.maxLength!==undefined && v.length>s.maxLength) e.push(`${p} too long`)
+    if (s.pattern && !new RegExp(s.pattern).test(v)) e.push(`${p} pattern mismatch`)
+    if (s.format==='uri'){ try{new URL(v)}catch{e.push(`${p} bad URI`)} } }
+  if (s.type==='array' && Array.isArray(v)){
+    if (s.uniqueItems && new Set(v).size!==v.length) e.push(`${p} duplicates`)
+    if (s.items) v.forEach((x,i)=>e.push(...validate(x,s.items,`${p}[${i}]`))) }
+  return e }

package/skills/c9n/SKILL.md

@@ -0,0 +1,174 @@
+---
+name: c9n
+description: CodePassion (C9N) engineering conventions — a single skill
+  covering workflow, branching, commits, PRs, code review, Clean Code TS,
+  ESLint, formatting, JSON:API, Go/No Go, and SemVer 2.0.0.
+version: 1.0.0
+tags: [c9n, codepassion, conventions]
+homepage: https://github.com/codepassion-team/c9n
+license: MIT
+---
+<!-- AUTO-GENERATED. Edit skills/c9n-*/SKILL.md, then: npm run build -->
+# C9N — CodePassion Engineering Conventions (combined)
+
+
+---
+
+## Development Workflow
+
+## Workflow
+1. Pick up ticket. 2. Clarify requirements. 3. Analyze ("To Analyze").
+4. Estimate. 5. "Ready for Dev". 6. "Dev in Progress" + draft PR.
+7. Update status. 8. Write tests. 9. "Ready for Code Review".
+10. Address feedback, merge. 11. "Ready to Deploy", tag vX.Y.Z.
+12. Validate in Alpha. 13. "Ready for QA". 14. Pass → Done; fail → Reopened.
+
+
+
+---
+
+## Git Branching
+
+## Format: `<type>/<description>`
+Types: `feature/`|`feat/`, `bugfix/`|`fix/`, `hotfix/`, `release/`, `chore/`.
+Rules: lowercase; hyphens only; no special chars; no consecutive or leading/
+trailing separators; dots only in `release/`; include ticket ID; be specific;
+no personal names; under 50 chars.
+Reference: https://conventional-branch.github.io
+
+
+
+---
+
+## Commit Messages
+
+## Format
+`<type>[scope]: <description>` + optional body + optional footer.
+Types/SemVer: `feat`→MINOR, `fix`/`perf`→PATCH, others→none.
+Breaking: `feat!:` or `BREAKING CHANGE:` footer → MAJOR.
+Rules: imperative; lowercase after colon; no trailing period; ≤50 char
+subject; one scope; reference tickets in footer (`Closes #123`).
+Reference: https://www.conventionalcommits.org
+
+
+
+---
+
+## Pull Requests
+
+## Subject: `#[Ticket_ID] PR description`
+Rules: ticket prefix; imperative mood; capitalize first word; no trailing
+period; body covers what/why/changes/testing + `Closes #TICKET`; open as
+draft until tests are written.
+
+
+
+---
+
+## Code Review
+
+## Format: `<label> [decorations]: <subject>`
+Labels: praise, nitpick, suggestion, issue, question, todo, chore.
+Decorations: (non-blocking), (blocking), (if-minor).
+Pair `issue` with `(blocking)` when must-fix. Use GitHub suggestion blocks.
+Batch with "Start a review". Never approve your own PR.
+Reference: https://conventionalcomments.org
+
+
+
+---
+
+## Clean Code Typescript
+
+## Rules
+Variables: meaningful names, named constants, default args.
+Functions: ≤2 args (options object), one thing, one abstraction level.
+Objects: `readonly`, type aliases.
+Classes: composition over inheritance, access modifiers, SRP.
+SOLID: SRP, Open/Closed, Liskov, Interface Segregation, Dependency Inversion.
+Errors: subclass `Error`; never strings; never empty `catch`.
+Tests: one concept per test; descriptive names; Arrange-Act-Assert.
+Reference: https://github.com/labs42io/clean-code-typescript
+
+
+
+---
+
+## Typescript Eslint
+
+## Required rules
+no-explicit-any (err), explicit-function-return-type (warn),
+no-unused-vars w/ ^_ (err), consistent-type-imports (err),
+no-floating-promises (err), strict-boolean-expressions (warn),
+naming-convention (err), no-non-null-assertion (err),
+no-misused-promises (err), prefer-nullish-coalescing (warn).
+tsconfig strict flags: strict, noUncheckedIndexedAccess, noImplicitOverride,
+noPropertyAccessFromIndexSignature, forceConsistentCasingInFileNames,
+verbatimModuleSyntax, exactOptionalPropertyTypes.
+Reference: https://typescript-eslint.io
+
+
+
+---
+
+## Code Formatting
+
+## Prettier
+semi false; singleQuote true; trailingComma none; printWidth 100;
+tabWidth 2; useTabs false; bracketSpacing true; arrowParens always;
+endOfLine lf.
+## EditorConfig
+UTF-8, 2-space indent, LF, trim trailing whitespace (except *.md), final
+newline.
+## lint-staged
+*.{ts,tsx}: prettier --write, eslint --fix.
+*.{json,md,yaml}: prettier --write.
+Rule: ESLint never enforces formatting; Prettier owns formatting.
+
+
+
+---
+
+## Jsonapi
+
+## Top-level
+data | errors | meta | links | included | jsonapi. Never mix data+errors.
+## Resource
+Every resource has type+id. Data in attributes; connections in
+relationships; hyperlinks in links.
+## Errors
+status, title, detail, source.pointer.
+## Rules
+Plural type names; sparse fieldsets (?fields[articles]=title,body); meta
+for non-standard info — no invented top-level members.
+Reference: https://jsonapi.org
+
+
+
+---
+
+## Go No Go Release
+
+## Gate
+Every item must be Go; one No Go blocks the release.
+Participants: Tech Lead (decision), Developer, QA, Product Owner.
+Checklist: PRs merged + CI green + no critical/high bugs; acceptance
+verified + regression + perf OK; release notes + migrations + rollback +
+env config; PO approval + support briefed + release window agreed.
+Outcomes: Go → tag vX.Y.Z, deploy, monitor; No Go → log blockers, no tag.
+
+
+
+---
+
+## Semver Deployment
+
+## Format: vMAJOR.MINOR.PATCH (lowercase v always)
+MAJOR=incompatible API change; MINOR=backwards-compatible feature;
+PATCH=backwards-compatible fix/security/perf.
+Pre-release: v1.5.0-alpha|beta|rc.1 (lower precedence).
+Build meta: v1.5.0+20250401.sha.abc1234 (informational).
+Alpha: tag from develop, `git tag -a vX.Y.Z -m "Release vX.Y.Z" && git push origin vX.Y.Z`.
+Production: confirm Go → pull release branch → create release → CI deploys → monitor.
+Reference: https://semver.org/spec/v2.0.0.html
+

package/skills/c9n-clean-code-typescript/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: c9n-clean-code-typescript
+description: Clean Code principles adapted for TypeScript by the C9N team.
+  Use whenever writing or refactoring TypeScript — naming, functions,
+  classes, SOLID, error handling, and testing.
+---
+# Rules
+Variables: meaningful names, named constants, default args.
+Functions: ≤2 args (options object), one thing, one abstraction level.
+Objects: `readonly`, type aliases.
+Classes: composition over inheritance, access modifiers, SRP.
+SOLID: SRP, Open/Closed, Liskov, Interface Segregation, Dependency Inversion.
+Errors: subclass `Error`; never strings; never empty `catch`.
+Tests: one concept per test; descriptive names; Arrange-Act-Assert.
+Reference: https://github.com/labs42io/clean-code-typescript

package/skills/c9n-code-formatting/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: c9n-code-formatting
+description: C9N's Prettier, EditorConfig, and lint-staged setup for
+  consistent formatting. Use when bootstrapping a repo or fixing
+  formatting drift.
+---
+# Prettier
+semi false; singleQuote true; trailingComma none; printWidth 100;
+tabWidth 2; useTabs false; bracketSpacing true; arrowParens always;
+endOfLine lf.
+# EditorConfig
+UTF-8, 2-space indent, LF, trim trailing whitespace (except *.md), final
+newline.
+# lint-staged
+*.{ts,tsx}: prettier --write, eslint --fix.
+*.{json,md,yaml}: prettier --write.
+Rule: ESLint never enforces formatting; Prettier owns formatting.

package/skills/c9n-code-review/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: c9n-code-review
+description: Conventional Comments labels for C9N code review. Use whenever
+  leaving review feedback or summarizing review comments, to ensure each
+  comment is actionable and unambiguous.
+---
+# Format: `<label> [decorations]: <subject>`
+Labels: praise, nitpick, suggestion, issue, question, todo, chore.
+Decorations: (non-blocking), (blocking), (if-minor).
+Pair `issue` with `(blocking)` when must-fix. Use GitHub suggestion blocks.
+Batch with "Start a review". Never approve your own PR.
+Reference: https://conventionalcomments.org

package/skills/c9n-commit-messages/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: c9n-commit-messages
+description: Conventional Commits for the C9N team — generates and validates
+  commit messages that drive automated Semantic Versioning. Use whenever
+  composing, squashing, or amending commits.
+---
+# Format
+`<type>[scope]: <description>` + optional body + optional footer.
+Types/SemVer: `feat`→MINOR, `fix`/`perf`→PATCH, others→none.
+Breaking: `feat!:` or `BREAKING CHANGE:` footer → MAJOR.
+Rules: imperative; lowercase after colon; no trailing period; ≤50 char
+subject; one scope; reference tickets in footer (`Closes #123`).
+Reference: https://www.conventionalcommits.org

package/skills/c9n-development-workflow/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: c9n-development-workflow
+description: C9N ticket-driven workflow — guides the agent from Jira "Pick up"
+  to "Done", covering clarification, analysis, estimation, draft PRs, tests,
+  code review, Alpha deployment, and QA handoff.
+---
+# Workflow
+1. Pick up ticket. 2. Clarify requirements. 3. Analyze ("To Analyze").
+4. Estimate. 5. "Ready for Dev". 6. "Dev in Progress" + draft PR.
+7. Update status. 8. Write tests. 9. "Ready for Code Review".
+10. Address feedback, merge. 11. "Ready to Deploy", tag vX.Y.Z.
+12. Validate in Alpha. 13. "Ready for QA". 14. Pass → Done; fail → Reopened.

package/skills/c9n-git-branching/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: c9n-git-branching
+description: Conventional Branch naming for the C9N team. Use whenever
+  creating, renaming, or reviewing a Git branch. Enforces lowercase,
+  hyphenated <type>/<description>.
+---
+# Format: `<type>/<description>`
+Types: `feature/`|`feat/`, `bugfix/`|`fix/`, `hotfix/`, `release/`, `chore/`.
+Rules: lowercase; hyphens only; no special chars; no consecutive or leading/
+trailing separators; dots only in `release/`; include ticket ID; be specific;
+no personal names; under 50 chars.
+Reference: https://conventional-branch.github.io

package/skills/c9n-go-no-go-release/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: c9n-go-no-go-release
+description: C9N's Go/No Go release decision gate held after QA sign-off and
+  before production deployment. Use whenever preparing a production release
+  or running a release meeting.
+---
+# Gate
+Every item must be Go; one No Go blocks the release.
+Participants: Tech Lead (decision), Developer, QA, Product Owner.
+Checklist: PRs merged + CI green + no critical/high bugs; acceptance
+verified + regression + perf OK; release notes + migrations + rollback +
+env config; PO approval + support briefed + release window agreed.
+Outcomes: Go → tag vX.Y.Z, deploy, monitor; No Go → log blockers, no tag.

package/skills/c9n-jsonapi/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: c9n-jsonapi
+description: JSON:API specification as adopted by the C9N team. Use whenever
+  designing, implementing, or reviewing RESTful endpoints, payloads, or
+  API client code.
+---
+# Top-level
+data | errors | meta | links | included | jsonapi. Never mix data+errors.
+# Resource
+Every resource has type+id. Data in attributes; connections in
+relationships; hyperlinks in links.
+# Errors
+status, title, detail, source.pointer.
+# Rules
+Plural type names; sparse fieldsets (?fields[articles]=title,body); meta
+for non-standard info — no invented top-level members.
+Reference: https://jsonapi.org

package/skills/c9n-pull-requests/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: c9n-pull-requests
+description: C9N pull-request title and body conventions. Use whenever
+  opening a PR, editing a PR title/description, or reviewing PR hygiene.
+  Enforces ticket-prefixed, imperative subjects.
+---
+# Subject: `#[Ticket_ID] PR description`
+Rules: ticket prefix; imperative mood; capitalize first word; no trailing
+period; body covers what/why/changes/testing + `Closes #TICKET`; open as
+draft until tests are written.

package/skills/c9n-semver-deployment/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: c9n-semver-deployment
+description: C9N's Semantic Versioning 2.0.0 policy and deployment steps
+  for Alpha and Production. Use whenever bumping a version, tagging a
+  release, or deploying.
+---
+# Format: vMAJOR.MINOR.PATCH (lowercase v always)
+MAJOR=incompatible API change; MINOR=backwards-compatible feature;
+PATCH=backwards-compatible fix/security/perf.
+Pre-release: v1.5.0-alpha|beta|rc.1 (lower precedence).
+Build meta: v1.5.0+20250401.sha.abc1234 (informational).
+Alpha: tag from develop, `git tag -a vX.Y.Z -m "Release vX.Y.Z" && git push origin vX.Y.Z`.
+Production: confirm Go → pull release branch → create release → CI deploys → monitor.
+Reference: https://semver.org/spec/v2.0.0.html

package/skills/c9n-typescript-eslint/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: c9n-typescript-eslint
+description: C9N's recommended ESLint (typescript-eslint) and tsconfig
+  settings. Use when bootstrapping a TypeScript project, fixing lint
+  errors, or auditing type safety.
+---
+# Required rules
+no-explicit-any (err), explicit-function-return-type (warn),
+no-unused-vars w/ ^_ (err), consistent-type-imports (err),
+no-floating-promises (err), strict-boolean-expressions (warn),
+naming-convention (err), no-non-null-assertion (err),
+no-misused-promises (err), prefer-nullish-coalescing (warn).
+tsconfig strict flags: strict, noUncheckedIndexedAccess, noImplicitOverride,
+noPropertyAccessFromIndexSignature, forceConsistentCasingInFileNames,
+verbatimModuleSyntax, exactOptionalPropertyTypes.
+Reference: https://typescript-eslint.io