@moskala/oneagent-templates 0.3.1 → 0.4.0

package/README.md

@@ -201,3 +201,54 @@ Follow the team coding standards documented in Notion.
 ```
 
 Skills, plugins, and rules are all optional.
+
+---
+
+## `extends`
+
+Templates can inherit from other templates using the `extends` field. The child template only needs to define what it **adds** — skills, plugins, and rules from the parent are merged automatically.
+
+```yaml
+name: my-react-template
+description: Our React starter
+extends: https://github.com/moskalakamil/oneagent-template
+
+skills:
+  - repo: https://github.com/anthropics/skills
+    skill: frontend-design
+plugins:
+  - target: claude
+    id: frontend-design@claude-plugins-official
+```
+
+### What `extends` accepts
+
+| Value | Example | Description |
+|-------|---------|-------------|
+| Builtin template name | `extends: default` | Inherits from one of the built-in templates (`default`, `react`, `react-native`) |
+| GitHub URL | `extends: https://github.com/org/template` | Inherits from a remote template (supports `/tree/branch/subdir` URLs) |
+
+### Merge behavior
+
+| Field | Behavior |
+|-------|----------|
+| `skills` | `[...parent.skills, ...own.skills]` |
+| `plugins` | `[...parent.plugins, ...own.plugins]` |
+| `rules` | `[...parent.rules, ...own.rules]` |
+| `instructions` | **Not inherited** — each template has its own `instructions.md` |
+
+### Chaining
+
+Extends is recursive. The built-in templates form a chain:
+
+```
+react-native → react → default
+```
+
+- `default` defines 7 skills and 9 plugins
+- `react` adds 7 skills and 2 plugins (total after merge: 14 skills, 11 plugins)
+- `react-native` adds 5 skills (total after merge: 19 skills, 11 plugins)
+
+### Limitations
+
+Remote templates (fetched from GitHub) can only extend other remote templates via URL — not built-in template names.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moskala/oneagent-templates",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "type": "module",
   "description": "Built-in templates for oneagent",
   "license": "MIT",
@@ -16,7 +16,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@moskala/oneagent-core": "0.2.5"
+    "@moskala/oneagent-core": "0.3.1"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/src/index.ts

@@ -1,7 +1,7 @@
 import path from "path";
 import fs from "fs/promises";
 import { fileURLToPath } from "url";
-import { type TemplatePlugin, type TemplateDefinition, parseTemplateYaml } from "@moskala/oneagent-core";
+import { type TemplatePlugin, type TemplateDefinition, parseTemplateYaml, resolveExtends } from "@moskala/oneagent-core";
 
 export type { TemplatePlugin, TemplateDefinition };
 
@@ -19,7 +19,7 @@ async function loadTemplate(name: BuiltinTemplateName): Promise<TemplateDefiniti
     fs.readFile(path.join(templateDir, "instructions.md"), "utf-8"),
   ]);
 
-  const { description, skills, plugins } = parseTemplateYaml(yamlText, name);
+  const parsed = parseTemplateYaml(yamlText, name);
 
   const rulesDir = path.join(templateDir, "rules");
   let rules: Array<{ name: string; content: string }> = [];
@@ -37,7 +37,8 @@ async function loadTemplate(name: BuiltinTemplateName): Promise<TemplateDefiniti
     // No rules directory — fine
   }
 
-  return { name, description, skills, plugins, instructions, rules };
+  const base = { ...parsed, instructions, rules };
+  return resolveExtends(base, (n) => resolveBuiltinTemplate(n));
 }
 
 export async function resolveBuiltinTemplate(name: string): Promise<TemplateDefinition | null> {

package/src/templates/default/template.yml

@@ -3,8 +3,8 @@ description: General programming starter
 skills:
   - repo: https://github.com/vercel-labs/skills
     skill: find-skills
-  - repo: https://github.com/anthropics/skills
-    skill: skill-creator
+  - repo: https://github.com/obra/superpowers
+    skill: writing-skills
   - repo: https://github.com/github/awesome-copilot
     skill: conventional-commit
   - repo: https://github.com/oldwinter/skills

package/src/templates/react/template.yml

@@ -1,20 +1,7 @@
 name: react
 description: React / Next.js project starter
+extends: default
 skills:
-  - repo: https://github.com/vercel-labs/skills
-    skill: find-skills
-  - repo: https://github.com/anthropics/skills
-    skill: skill-creator
-  - repo: https://github.com/github/awesome-copilot
-    skill: conventional-commit
-  - repo: https://github.com/oldwinter/skills
-    skill: github-cli
-  - repo: https://github.com/supercent-io/skills-template
-    skill: code-review
-  - repo: https://github.com/vercel-labs/agent-skills
-    skill: web-design-guidelines
-  - repo: https://github.com/coreyhaines31/marketingskills
-    skill: copywriting
   - repo: https://github.com/anthropics/skills
     skill: frontend-design
   - repo: https://github.com/vercel-labs/agent-skills
@@ -30,25 +17,7 @@ skills:
   - repo: https://github.com/wshobson/agents
     skill: react-state-management
 plugins:
-  - target: claude
-    id: context7@claude-plugins-official
-  - target: claude
-    id: superpowers@claude-plugins-official
-  - target: claude
-    id: code-simplifier@claude-plugins-official
-  - target: claude
-    id: security-guidance@claude-plugins-official
-  - target: claude
-    id: claude-md-management@claude-plugins-official
   - target: claude
     id: frontend-design@claude-plugins-official
   - target: claude
     id: typescript-lsp@claude-plugins-official
-  - target: opencode
-    id: oh-my-opencode
-  - target: opencode
-    id: "@plannotator/opencode"
-  - target: opencode
-    id: "@openspoon/subtask2"
-  - target: opencode
-    id: micode

package/src/templates/react-native/template.yml

@@ -1,34 +1,7 @@
 name: react-native
 description: React Native / Expo project starter
+extends: react
 skills:
-  - repo: https://github.com/vercel-labs/skills
-    skill: find-skills
-  - repo: https://github.com/anthropics/skills
-    skill: skill-creator
-  - repo: https://github.com/github/awesome-copilot
-    skill: conventional-commit
-  - repo: https://github.com/oldwinter/skills
-    skill: github-cli
-  - repo: https://github.com/supercent-io/skills-template
-    skill: code-review
-  - repo: https://github.com/vercel-labs/agent-skills
-    skill: web-design-guidelines
-  - repo: https://github.com/coreyhaines31/marketingskills
-    skill: copywriting
-  - repo: https://github.com/anthropics/skills
-    skill: frontend-design
-  - repo: https://github.com/vercel-labs/agent-skills
-    skill: vercel-react-best-practices
-  - repo: https://github.com/vercel-labs/agent-skills
-    skill: vercel-composition-patterns
-  - repo: https://github.com/obra/superpowers
-    skill: brainstorming
-  - repo: https://github.com/coreyhaines31/marketingskills
-    skill: seo-audit
-  - repo: https://github.com/vercel-labs/next-skills
-    skill: next-best-practices
-  - repo: https://github.com/wshobson/agents
-    skill: react-state-management
   - repo: https://github.com/vercel-labs/agent-skills
     skill: vercel-react-native-skills
   - repo: https://github.com/callstackincubator/agent-skills
@@ -39,26 +12,3 @@ skills:
     skill: upgrading-expo
   - repo: https://github.com/conorluddy/ios-simulator-skill
     skill: ios-simulator-skill
-plugins:
-  - target: claude
-    id: context7@claude-plugins-official
-  - target: claude
-    id: superpowers@claude-plugins-official
-  - target: claude
-    id: code-simplifier@claude-plugins-official
-  - target: claude
-    id: security-guidance@claude-plugins-official
-  - target: claude
-    id: claude-md-management@claude-plugins-official
-  - target: claude
-    id: frontend-design@claude-plugins-official
-  - target: claude
-    id: typescript-lsp@claude-plugins-official
-  - target: opencode
-    id: oh-my-opencode
-  - target: opencode
-    id: "@plannotator/opencode"
-  - target: opencode
-    id: "@openspoon/subtask2"
-  - target: opencode
-    id: micode