@codedrifters/configulator 0.0.214 → 0.0.215

package/lib/index.d.mts

@@ -198,9 +198,38 @@ interface AgentSkill {
     readonly paths?: ReadonlyArray<string>;
     /**
      * Resource directories bundled with the skill (e.g., references/, scripts/, assets/).
+     * Documentation hint only — directory names listed here are not emitted to disk.
+     * Prefer {@link referenceFiles} to ship actual companion file contents.
+     *
+     * @deprecated Use {@link referenceFiles} to emit physical companion files.
      * @example ['references/', 'scripts/']
      */
     readonly references?: ReadonlyArray<string>;
+    /**
+     * Companion files shipped alongside the SKILL.md (e.g., templates, references, scripts).
+     * Each entry is rendered as a TextFile under the skill's directory on every
+     * platform that emits skills (Claude: `.claude/skills/{name}/{path}`,
+     * Cursor: `.cursor/skills/{name}/{path}`).
+     *
+     * Use this for skill assets that benefit from being separate files rather than
+     * inlined into the skill instructions — large templates, reference tables,
+     * runnable scripts.
+     *
+     * Per-platform `platforms.{claude,cursor}.exclude` flags suppress reference
+     * files for that platform alongside the SKILL.md.
+     *
+     * @example
+     * referenceFiles: [
+     *   { path: '_references/templates/_template-FR.md', content: '# Functional Requirement\n...' },
+     *   { path: '_references/standards-and-frameworks.md', content: '# Standards\n...' },
+     * ]
+     */
+    readonly referenceFiles?: ReadonlyArray<{
+        /** Path relative to the skill directory (e.g., `_references/templates/_template-FR.md`). */
+        readonly path: string;
+        /** File contents written verbatim. */
+        readonly content: string;
+    }>;
     /**
      * Context isolation mode. Set to 'fork' to run in an isolated subagent context.
      */

package/lib/index.d.ts

@@ -247,9 +247,38 @@ interface AgentSkill {
     readonly paths?: ReadonlyArray<string>;
     /**
      * Resource directories bundled with the skill (e.g., references/, scripts/, assets/).
+     * Documentation hint only — directory names listed here are not emitted to disk.
+     * Prefer {@link referenceFiles} to ship actual companion file contents.
+     *
+     * @deprecated Use {@link referenceFiles} to emit physical companion files.
      * @example ['references/', 'scripts/']
      */
     readonly references?: ReadonlyArray<string>;
+    /**
+     * Companion files shipped alongside the SKILL.md (e.g., templates, references, scripts).
+     * Each entry is rendered as a TextFile under the skill's directory on every
+     * platform that emits skills (Claude: `.claude/skills/{name}/{path}`,
+     * Cursor: `.cursor/skills/{name}/{path}`).
+     *
+     * Use this for skill assets that benefit from being separate files rather than
+     * inlined into the skill instructions — large templates, reference tables,
+     * runnable scripts.
+     *
+     * Per-platform `platforms.{claude,cursor}.exclude` flags suppress reference
+     * files for that platform alongside the SKILL.md.
+     *
+     * @example
+     * referenceFiles: [
+     *   { path: '_references/templates/_template-FR.md', content: '# Functional Requirement\n...' },
+     *   { path: '_references/standards-and-frameworks.md', content: '# Standards\n...' },
+     * ]
+     */
+    readonly referenceFiles?: ReadonlyArray<{
+        /** Path relative to the skill directory (e.g., `_references/templates/_template-FR.md`). */
+        readonly path: string;
+        /** File contents written verbatim. */
+        readonly content: string;
+    }>;
     /**
      * Context isolation mode. Set to 'fork' to run in an isolated subagent context.
      */

package/lib/index.js

@@ -8400,6 +8400,13 @@ var ClaudeRenderer = class _ClaudeRenderer {
       new import_textfile2.TextFile(component, `.claude/skills/${skill.name}/SKILL.md`, {
         lines
       });
+      if (skill.referenceFiles && skill.referenceFiles.length > 0) {
+        for (const file of skill.referenceFiles) {
+          new import_textfile2.TextFile(component, `.claude/skills/${skill.name}/${file.path}`, {
+            lines: file.content.split("\n")
+          });
+        }
+      }
     }
   }
   static renderSubAgents(component, subAgents) {
@@ -8571,6 +8578,13 @@ var CursorRenderer = class _CursorRenderer {
       new import_textfile3.TextFile(component, `.cursor/skills/${skill.name}/SKILL.md`, {
         lines
       });
+      if (skill.referenceFiles && skill.referenceFiles.length > 0) {
+        for (const file of skill.referenceFiles) {
+          new import_textfile3.TextFile(component, `.cursor/skills/${skill.name}/${file.path}`, {
+            lines: file.content.split("\n")
+          });
+        }
+      }
     }
   }
   static renderSubAgents(component, subAgents) {