teamcast 1.0.2 → 1.0.3

package/README.md

@@ -1,11 +1,17 @@
 # TeamCast
 
+[![CI](https://github.com/Katoshy/teamcast/actions/workflows/ci.yml/badge.svg)](https://github.com/Katoshy/teamcast/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/teamcast)](https://www.npmjs.com/package/teamcast)
+[![License](https://img.shields.io/github/license/Katoshy/teamcast)](https://github.com/Katoshy/teamcast/blob/main/LICENSE)
+
 CLI to design, generate, and validate multi-target agent teams for Claude Code and Codex from a single manifest.
 
 Define your agent team in one `teamcast.yaml` file. TeamCast validates the manifest, generates `.claude/` and/or `.codex/` config files, and keeps generated output in sync with the source config.
 
 ## Install
 
+Requires Node.js 24 or newer.
+
 ```bash
 npm install -g teamcast
 ```
@@ -16,6 +22,14 @@ Or run without installing:
 npx teamcast <command>
 ```
 
+## Community
+
+- Contribution guide: [CONTRIBUTING.md](./CONTRIBUTING.md)
+- Code of conduct: [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)
+- Security policy: [SECURITY.md](./SECURITY.md)
+- Bug reports and feature requests: use the GitHub issue templates
+- Pull requests: use the repository PR template and run `npm test` plus `npm run build` before opening one
+
 ## Quick Start
 
 ```bash
@@ -43,6 +57,7 @@ After `generate`, your project will have files for the selected target(s):
 - Codex target:
   - `.codex/config.toml` - workspace-level Codex config
   - `.codex/agents/<name>.toml` - one TOML config per agent
+  - `.agents/skills/<skill>/SKILL.md` - one stub file per unique skill
   - `AGENTS.md` - team-level instructions for Codex agents
 
 Use `teamcast init --target claude|codex|both` to choose which outputs are generated up front.
@@ -273,7 +288,7 @@ Use `--yes` to skip confirmation.
 
 ### `create skill <name>`
 
-`teamcast create skill <name>` registers a new skill name on one agent, writes `teamcast.yaml`, and generates `.claude/skills/<name>/SKILL.md`.
+`teamcast create skill <name>` registers a new skill name on one agent, writes `teamcast.yaml`, and generates a target-specific stub: `.claude/skills/<name>/SKILL.md` for Claude or `.agents/skills/<name>/SKILL.md` for Codex.
 
 Rules and prompts:
 
@@ -310,7 +325,7 @@ teamcast generate --dry-run
 Behavior:
 
 - `generate` overwrites generated agent/docs/settings files
-- skill stub files under `.claude/skills/` are created only if missing
+- skill stub files under `.claude/skills/` and `.agents/skills/` are created only if missing
 - `--dry-run` shows what would be generated without writing anything
 
 ### `diff`
@@ -429,6 +444,7 @@ It targets:
 
 - `.claude/agents`
 - `.claude/skills`
+- generated Codex skill files under `.agents/skills/`
 - `.claude/settings.json`
 - `.claude/settings.local.json`
 - `CLAUDE.md`
@@ -467,9 +483,9 @@ Everything is defined in `teamcast.yaml` at the root of your project.
 
 For Claude targets, TeamCast renders `.claude/agents/<name>.md` and `CLAUDE.md` from `claude.agents.<name>`.
 
-For Codex targets, TeamCast renders `.codex/agents/<name>.toml` plus `.codex/config.toml` from `codex.agents.<name>`.
+For Codex targets, TeamCast renders `.codex/agents/<name>.toml` plus `.codex/config.toml` from `codex.agents.<name>`, and writes Codex skill docs to `.agents/skills/<skill>/`.
 
-`.codex/config.toml` is the workspace-level agent index. Concrete agent runtime config lives in `.codex/agents/<name>.toml`.
+`.codex/config.toml` is the workspace-level agent index. Concrete agent runtime config lives in `.codex/agents/<name>.toml`. Codex skill discovery uses `.agents/skills/`, not `.codex/`.
 
 Native Claude Code fields are rendered into frontmatter:
 
@@ -642,6 +658,7 @@ claude:
 | `claude.tools`            | string[]                                                         | Native Claude Code tool allow-list                                                             |
 | `claude.disallowed_tools` | string[]                                                         | Native Claude Code tool deny-list                                                              |
 | `claude.skills`           | string[]                                                         | Skill names. Each unique skill generates `.claude/skills/<skill>/SKILL.md`                     |
+| `codex.skills`            | string[]                                                         | Skill names. Each unique skill generates `.agents/skills/<skill>/SKILL.md`                     |
 | `claude.max_turns`        | number                                                           | Maximum agentic turns                                                                          |
 | `claude.mcp_servers`      | object[]                                                         | MCP server definitions                                                                         |
 | `claude.permission_mode`  | `default \| acceptEdits \| bypassPermissions \| plan \| dontAsk` | Claude Code permission mode                                                                    |

package/dist/application/build-generated-files.js

@@ -7,8 +7,11 @@ export function buildGeneratedOutputs(team, targetName, options) {
     const renderer = target.renderer;
     const files = renderer.render(spec);
     if (!options.dryRun) {
-        const editable = files.filter((file) => isUserEditableGeneratedFile(file.path));
-        const generated = files.filter((file) => !isUserEditableGeneratedFile(file.path));
+        const editable = [];
+        const generated = [];
+        for (const file of files) {
+            (isUserEditableGeneratedFile(file.path) ? editable : generated).push(file);
+        }
         writeFiles(generated, options.cwd);
         writeFiles(editable, options.cwd, { skipExisting: true });
     }

package/dist/cli/registrars/manage.js

@@ -12,7 +12,7 @@ export function registerManageCommands(program) {
     const createCmd = program.command('create').description('Create a new resource');
     createCmd
         .command('skill <name>')
-        .description('Create a new skill (generates stub file in .claude/skills/)')
+        .description('Create a new skill (Claude: .claude/skills/, Codex: .agents/skills/)')
         .option('--target <name>', 'Target block to modify')
         .action(async (name, options) => {
         const { runCreateSkillCommand } = await import('../manage.js');

package/dist/cli/reset.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import { existsSync, rmSync, readdirSync, statSync } from 'fs';
-import { join } from 'path';
+import { dirname, join } from 'path';
 import { readManifest, ManifestError } from '../manifest/reader.js';
 import { generate } from '../generator/index.js';
 import { printSuccess, printHeader, printCommandSuccess, printDim, } from '../utils/chalk-helpers.js';
@@ -47,6 +47,22 @@ function deleteEmptyDirIfPossible(cwd, rel) {
         printSuccess(`Deleted ${rel}/`);
     }
 }
+function pruneEmptyAncestorDirs(cwd, rel) {
+    let current = dirname(rel);
+    while (current !== '.' && current !== '') {
+        const abs = join(cwd, current);
+        if (!existsSync(abs)) {
+            current = dirname(current);
+            continue;
+        }
+        if (readdirSync(abs).length > 0) {
+            break;
+        }
+        rmSync(abs, { recursive: true });
+        printSuccess(`Deleted ${current}/`);
+        current = dirname(current);
+    }
+}
 function deleteFiles(cwd, paths) {
     for (const rel of paths) {
         const abs = join(cwd, rel);
@@ -60,6 +76,7 @@ function deleteFiles(cwd, paths) {
             rmSync(abs);
         }
         printSuccess(`Deleted ${rel}`);
+        pruneEmptyAncestorDirs(cwd, rel);
     }
     deleteEmptyDirIfPossible(cwd, '.claude/agents');
     deleteEmptyDirIfPossible(cwd, '.claude/skills');

package/dist/generator/file-policies.js

@@ -1,3 +1,3 @@
 export function isUserEditableGeneratedFile(path) {
-    return path.startsWith('.claude/skills/');
+    return path.startsWith('.claude/skills/') || path.startsWith('.agents/skills/');
 }

package/dist/renderers/codex/skill-md.js

@@ -1,5 +1,8 @@
-// Codex skill renderer — generates {id}/SKILL.md + agents/openai.yaml per skill.
+// Codex skill renderer — generates .agents/skills/{id}/SKILL.md + agents/openai.yaml per skill.
 import { defaultRegistry } from '../../registry/index.js';
+function getSkillBasePath(skillId) {
+    return `.agents/skills/${skillId}`;
+}
 // --- Frontmatter (Codex: name + description only) ---
 function buildFrontmatter(name, description) {
     return ['---', `name: ${name}`, `description: ${description}`, '---'].join('\n');
@@ -59,15 +62,16 @@ function renderOpenaiYaml(skill) {
         if (skill.metadata.version)
             lines.push(`version: "${skill.metadata.version}"`);
     }
-    if (hasTools) {
+    if (hasTools || hasMcp) {
         lines.push('dependencies:');
+    }
+    if (hasTools) {
         lines.push('  tools:');
         for (const tool of skill.allowed_tools) {
             lines.push(`    - ${tool}`);
         }
     }
     if (hasMcp) {
-        lines.push('dependencies:');
         lines.push('  mcp_servers:');
         for (const server of skill.required_mcp_servers) {
             lines.push(`    - ${server}`);
@@ -78,7 +82,7 @@ function renderOpenaiYaml(skill) {
 // --- Companion files ---
 function renderCompanionFiles(skillId, skill) {
     const files = [];
-    const base = skillId;
+    const base = getSkillBasePath(skillId);
     if (skill.reference_files) {
         for (const [name, content] of Object.entries(skill.reference_files)) {
             files.push({ path: `${base}/references/${name}`, content });
@@ -108,14 +112,14 @@ export function renderCodexSkillMd(team) {
         const definition = defaultRegistry.getSkill(skillName);
         if (definition) {
             files.push({
-                path: `${skillName}/SKILL.md`,
+                path: `${getSkillBasePath(skillName)}/SKILL.md`,
                 content: renderSkillContent(definition),
             });
             files.push(...renderCompanionFiles(skillName, definition));
         }
         else {
             files.push({
-                path: `${skillName}/SKILL.md`,
+                path: `${getSkillBasePath(skillName)}/SKILL.md`,
                 content: generateSkillStub(skillName),
             });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teamcast",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "YAML-driven CLI to design, validate, and generate multi-target agent teams for Claude Code and Codex",
   "type": "module",
   "bin": {