fix(cli): init ships conciv skills — claude-connect plugin skills dir + @conciv/skills via @conciv/it

.changeset/init-ships-skills.md

@@ -0,0 +1,5 @@
+---
+'@conciv/cli': patch
+---
+
+conciv init ships the conciv skills: natively in the claude-connect plugin and via @conciv/skills for intent discovery

packages/cli/src/init/steps/harness/agents-md.ts

@@ -28,6 +28,8 @@ export function agentsSection(consented: HarnessId[]): string {
     '- `conciv tools server` - inspect and nudge the dev server; `--help` lists every capability',
     '',
     'These commands need the dev server running.',
+    '',
+    'conciv ships first-party skills. Before conciv work, run `pnpm dlx @tanstack/intent@latest list` and load what you need with `pnpm dlx @tanstack/intent@latest load @conciv/skills#<skill>`.',
     ...setUpFor,
     ...notes,
     '',

packages/cli/test/steps/harness/agents-md.test.ts

@@ -93,6 +93,15 @@ describe('agentsMdStep', () => {
     expect(readFileSync(join(cwd, 'AGENTS.md'), 'utf8')).toBe(doubled)
   })
 
+  it('writes the file an agent reads to find the conciv skills through intent', async () => {
+    const {cwd, settings, output} = project()
+    await runSteps([agentsMdStep(() => consented)], settings, output)
+    const written = readFileSync(join(cwd, 'AGENTS.md'), 'utf8')
+
+    expect(written).toContain('pnpm dlx @tanstack/intent@latest list')
+    expect(written).toContain('pnpm dlx @tanstack/intent@latest load @conciv/skills#<skill>')
+  })
+
   it('offers the section text itself as the manual card snippet', () => {
     const {ctx} = project()
     const card = agentsMdStep(() => consented).manualCard(ctx)

packages/harness-init/package.json

@@ -86,6 +86,7 @@
   },
   "dependencies": {
     "@conciv/protocol": "workspace:^",
+    "@conciv/skills": "workspace:^",
     "zod": "^4.4.3"
   },
   "devDependencies": {

packages/harness-init/src/claude/plugin-files.ts

@@ -2,6 +2,7 @@ import {join} from 'node:path'
 import type {HarnessConnectFile} from '@conciv/protocol/harness-types'
 import {claudeConnectBridgeSource, CLAUDE_CONNECT_BRIDGE_FILE} from './bridge.js'
 import {CLAUDE_CONNECT_MARKETPLACE, CLAUDE_CONNECT_MCP_SERVER, CLAUDE_CONNECT_PLUGIN} from './names.js'
+import {claudeConnectSkillFiles} from './skill-files.js'
 
 export const CLAUDE_CONNECT_ROOT = 'claude-connect'
 
@@ -74,5 +75,6 @@ export function claudeConnectPluginFiles(opts: {stateDir: string}): HarnessConne
       mode: BRIDGE_FILE_MODE,
     },
     {path: join(plugin, '.mcp.json'), contents: mcpManifest()},
+    ...claudeConnectSkillFiles(plugin),
   ]
 }

packages/harness-init/src/claude/skill-files.ts

@@ -0,0 +1,40 @@
+import {readdirSync, readFileSync} from 'node:fs'
+import {createRequire} from 'node:module'
+import {dirname, join, relative} from 'node:path'
+import type {HarnessConnectFile} from '@conciv/protocol/harness-types'
+
+export const CLAUDE_CONNECT_SKILLS_DIR = 'skills'
+
+const AUTHORING_DIR = '_artifacts'
+
+function skillsSourceDir(): string {
+  const packageManifest = createRequire(import.meta.url).resolve('@conciv/skills/package.json')
+  return join(dirname(packageManifest), 'skills')
+}
+
+function sortedEntries(dir: string): string[] {
+  return readdirSync(dir, {withFileTypes: true})
+    .flatMap((entry) => {
+      const full = join(dir, entry.name)
+      if (entry.isDirectory()) return sortedEntries(full)
+      return [full]
+    })
+    .toSorted()
+}
+
+function skillDirs(root: string): string[] {
+  return readdirSync(root, {withFileTypes: true})
+    .filter((entry) => entry.isDirectory() && entry.name !== AUTHORING_DIR)
+    .map((entry) => entry.name)
+    .toSorted()
+}
+
+export function claudeConnectSkillFiles(pluginDir: string): HarnessConnectFile[] {
+  const root = skillsSourceDir()
+  return skillDirs(root).flatMap((skill) =>
+    sortedEntries(join(root, skill)).map((file) => ({
+      path: join(pluginDir, CLAUDE_CONNECT_SKILLS_DIR, relative(root, file)),
+      contents: readFileSync(file, 'utf8'),
+    })),
+  )
+}

packages/harness-init/test/plugin-files.test.ts

@@ -1,4 +1,6 @@
-import {join, relative} from 'node:path'
+import {readFileSync} from 'node:fs'
+import {createRequire} from 'node:module'
+import {dirname, join, relative, sep} from 'node:path'
 import {describe, expect, it} from 'vitest'
 import {CLAUDE_CONNECT_BRIDGE_FILE} from '../src/claude/bridge.js'
 import {claudeConnectEndpointFile, claudeConnectEndpointPath} from '../src/claude/endpoint.js'
@@ -39,14 +41,49 @@ describe('claude connect plugin files', () => {
     })
   })
 
-  it('keeps every generated file free of dev server urls', () => {
-    for (const [, contents] of treeOf('/first/.conciv')) {
+  it('keeps every generated manifest free of dev server urls', () => {
+    for (const [path, contents] of treeOf('/first/.conciv')) {
+      if (path.includes(`${SKILLS_DIR}${sep}`)) continue
       expect(contents).not.toContain('127.0.0.1')
       expect(contents).not.toContain('http://')
     }
   })
 })
 
+const SKILLS_DIR = 'skills'
+
+function skillsSourceDir(): string {
+  return join(dirname(createRequire(import.meta.url).resolve('@conciv/skills/package.json')), 'skills')
+}
+
+function pluginPaths(): string[] {
+  return treeOf('/first/.conciv').map(([path]) => path)
+}
+
+describe('claude connect plugin skills', () => {
+  it('ships every published conciv skill so claude lists them natively', () => {
+    const shipped = pluginPaths().filter((path) => path.includes(`${SKILLS_DIR}${sep}`))
+
+    expect(shipped).toContain(join('conciv-connect', SKILLS_DIR, 'conciv-setup', 'SKILL.md'))
+    expect(shipped).toContain(join('conciv-connect', SKILLS_DIR, 'conciv-develop', 'SKILL.md'))
+    expect(shipped).toContain(join('conciv-connect', SKILLS_DIR, 'conciv-debug', 'SKILL.md'))
+    expect(shipped).toContain(join('conciv-connect', SKILLS_DIR, 'conciv-harness', 'SKILL.md'))
+  })
+
+  it('ships the reference files a skill points at, never the authoring artifacts', () => {
+    const shipped = pluginPaths().filter((path) => path.includes(`${SKILLS_DIR}${sep}`))
+
+    expect(shipped).toContain(join('conciv-connect', SKILLS_DIR, 'conciv-develop', 'references', 'tool-contract.md'))
+    expect(shipped.filter((path) => path.includes('_artifacts'))).toEqual([])
+  })
+
+  it('copies skill markdown byte for byte from the published package', () => {
+    const shipped = contentsAt('/first/.conciv', join('conciv-connect', SKILLS_DIR, 'conciv-setup', 'SKILL.md'))
+
+    expect(shipped).toBe(readFileSync(join(skillsSourceDir(), 'conciv-setup', 'SKILL.md'), 'utf8'))
+  })
+})
+
 describe('claude connect endpoint file', () => {
   it('records the dev server url outside the plugin tree that claude copies into its cache', () => {
     const stateDir = '/first/.conciv'

packages/it/package.json

@@ -72,7 +72,8 @@
     "@conciv/extension-terminal": "workspace:^",
     "@conciv/extension-test-runner": "workspace:^",
     "@conciv/extension-whiteboard": "workspace:^",
-    "@conciv/plugin": "workspace:^"
+    "@conciv/plugin": "workspace:^",
+    "@conciv/skills": "workspace:^"
   },
   "devDependencies": {
     "@conciv/vitest-config": "workspace:*",