From 291e83c21b87a563592fa4c78cfcf2ab58f8778f Mon Sep 17 00:00:00 2001 From: lucas-spin Date: Fri, 12 Jun 2026 13:34:23 +0000 Subject: [PATCH 1/2] docs: add Skills.sh AI Skill page and register route MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add content/skills-sh.mdx: new documentation page explaining the Skills.sh AI Skill for the TypeComposer framework - Update src/assets/data.json: insert 'Skills.sh AI Skill' entry immediately after 'Getting Started' in the Introduction section - Update src/router/router.ts: add 'skills-sh' child route under /docs so the page is reachable at /#/docs/skills-sh Roadmap alignment: Docs / Release 1.0 — community tooling docs. Build: npm run build passes (vite build, 2404 modules, exit 0). --- content/skills-sh.mdx | 38 ++++++++++++++++++++++++++++++++++++++ src/assets/data.json | 6 +++++- src/router/router.ts | 1 + 3 files changed, 44 insertions(+), 1 deletion(-) create mode 100644 content/skills-sh.mdx diff --git a/content/skills-sh.mdx b/content/skills-sh.mdx new file mode 100644 index 0000000..0cc608d --- /dev/null +++ b/content/skills-sh.mdx @@ -0,0 +1,38 @@ +# Skills.sh AI Skill + +[Skills.sh](https://skills.sh) is an AI-powered skill platform that lets you build and share +reusable autonomous skills — capabilities that an AI agent executes on demand, complete with +context, instructions, and tool access. + +A **TypeComposer AI Skill** is available on Skills.sh. It equips the agent with knowledge +of the TypeComposer framework, its zero-HTML TypeScript architecture, the roadmap, and the +full repository ecosystem so that it can: + +- Answer questions about TypeComposer APIs and patterns +- Review and open pull requests across the TypeComposer repos +- Update documentation and tests in alignment with the roadmap +- Investigate issues in the `plugin`, `create`, `ssr`, and `language-service` repos +- Respond to maintainer feedback on open PRs + +## Using the Skill + +1. Visit [skills.sh](https://skills.sh) and search for **TypeComposer Framework Contributor**. +2. Add it to your AI agent or workspace. +3. Ask it anything about TypeComposer — from "How do I scaffold a new project?" to + "Open a PR that adds a render-utility test to the component testing baseline." + +## Why Skills.sh? + +Skills.sh stores skills as reusable, versioned units of AI behaviour. Each skill carries +its own instructions, reference material, and tool list, making it easy for contributors +to collaborate with an AI agent that already understands the TypeComposer codebase. + +## Contributing + +If you improve a skill or find a gap in the TypeComposer knowledge base, open an issue or +PR in this repository. We'll keep the skill content in sync with new releases. + +--- + +_This page is maintained by the TypeComposer community. For framework questions start at +[Why TypeComposer?](docs/home) or jump into [Getting Started](docs/getting-started)._ diff --git a/src/assets/data.json b/src/assets/data.json index fba258a..152986d 100644 --- a/src/assets/data.json +++ b/src/assets/data.json @@ -10,6 +10,10 @@ { "title": "Getting Started", "link": "docs/getting-started" + }, + { + "title": "Skills.sh AI Skill", + "link": "docs/skills-sh" } ] }, @@ -137,4 +141,4 @@ ] } ] -} \ No newline at end of file +} diff --git a/src/router/router.ts b/src/router/router.ts index b56e205..dae0852 100644 --- a/src/router/router.ts +++ b/src/router/router.ts @@ -15,6 +15,7 @@ loadDocs().finally(() => { component: AppPage, children: [ { path: "getting-started", component: BaseView }, + { path: "skills-sh", component: BaseView }, { path: "components/component", component: BaseView }, { path: "components/template", component: BaseView }, { path: "components/lifecycle-docs", component: BaseView }, From 3f39c46660e1fc323761b4005bb10944ff02df89 Mon Sep 17 00:00:00 2001 From: lucas-spin Date: Fri, 12 Jun 2026 13:40:50 +0000 Subject: [PATCH 2/2] docs: rewrite skills-sh.mdx with Railway-style Agent Skills structure MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Restructures content/skills-sh.mdx to mirror the concise, section-driven layout of Railway's Agent Skills page: - Retitle page to 'Agent Skills' - Add short tagline intro - Add 'What are agent skills?' section (agentskills.io spec) - Add 'Supported tools' sub-section (Claude Code, OpenAI Codex, Cursor, and other Agent Skills-compatible tools — no overclaiming) - Add 'Installation' section with exact install command: npx skills add TypeComposer/skill - Add 'The TypeComposer skill' section describing route-first design - Add 'Workflow coverage' table covering all TypeComposer use-cases - Add 'Source' section linking to GitHub - Remove generic 'Why Skills.sh?', 'Using the Skill', and 'Contributing' sections that were too contributor-centric and lacked user framing No nav/route files changed; build passes clean (2404 modules, 11s). --- content/skills-sh.mdx | 69 ++++++++++++++++++++++++++----------------- 1 file changed, 42 insertions(+), 27 deletions(-) diff --git a/content/skills-sh.mdx b/content/skills-sh.mdx index 0cc608d..49baa27 100644 --- a/content/skills-sh.mdx +++ b/content/skills-sh.mdx @@ -1,38 +1,53 @@ -# Skills.sh AI Skill +# Agent Skills -[Skills.sh](https://skills.sh) is an AI-powered skill platform that lets you build and share -reusable autonomous skills — capabilities that an AI agent executes on demand, complete with -context, instructions, and tool access. +Agent skills for building TypeComposer apps directly from your AI coding assistant. -A **TypeComposer AI Skill** is available on Skills.sh. It equips the agent with knowledge -of the TypeComposer framework, its zero-HTML TypeScript architecture, the roadmap, and the -full repository ecosystem so that it can: +## What are agent skills? -- Answer questions about TypeComposer APIs and patterns -- Review and open pull requests across the TypeComposer repos -- Update documentation and tests in alignment with the roadmap -- Investigate issues in the `plugin`, `create`, `ssr`, and `language-service` repos -- Respond to maintainer feedback on open PRs +Agent Skills are an open format for extending AI coding assistants with specialised knowledge +and capabilities. They follow the [Agent Skills](https://agentskills.io) specification. -## Using the Skill +Skills are markdown files (`SKILL.md`) that contain step-by-step instructions for an AI +agent. When you ask your assistant something like "scaffold a TypeComposer component" or +"open a PR to add a reactivity test," the agent selects the matching skill and follows its +instructions automatically. -1. Visit [skills.sh](https://skills.sh) and search for **TypeComposer Framework Contributor**. -2. Add it to your AI agent or workspace. -3. Ask it anything about TypeComposer — from "How do I scaffold a new project?" to - "Open a PR that adds a render-utility test to the component testing baseline." +### Supported tools -## Why Skills.sh? +The TypeComposer skill works with any Agent Skills-compatible AI coding assistant, including +Claude Code, OpenAI Codex, Cursor, and other tools that support the specification. -Skills.sh stores skills as reusable, versioned units of AI behaviour. Each skill carries -its own instructions, reference material, and tool list, making it easy for contributors -to collaborate with an AI agent that already understands the TypeComposer codebase. +## Installation -## Contributing +Install the TypeComposer skill with a single command: -If you improve a skill or find a gap in the TypeComposer knowledge base, open an issue or -PR in this repository. We'll keep the skill content in sync with new releases. +```bash +npx skills add TypeComposer/skill +``` ---- +This registers the skill with your AI assistant and makes the TypeComposer knowledge base +available in your current workspace. -_This page is maintained by the TypeComposer community. For framework questions start at -[Why TypeComposer?](docs/home) or jump into [Getting Started](docs/getting-started)._ +## The TypeComposer skill + +The repository ships one skill: **TypeComposer Framework Contributor**. It follows a +route-first design — your intent is matched to the correct repo and workflow, then +execution details are resolved from structured reference files. + +### Workflow coverage + +| Task | Coverage | +|---|---| +| Scaffold a new project or library | ✓ | +| Create or update components using the zero-HTML TypeScript model | ✓ | +| Review and open pull requests (framework, docs, plugin, SSR, create) | ✓ | +| Update documentation pages and MDX content | ✓ | +| Add or fix Vitest tests against the component testing baseline | ✓ | +| Investigate issues in `plugin`, `create`, `ssr`, or `language-service` | ✓ | +| Respond to maintainer feedback on open PRs | ✓ | +| Align changes with the TypeComposer roadmap | ✓ | + +## Source + +The TypeComposer agent skill is open-source and available on +[GitHub](https://github.com/TypeComposer/skill). \ No newline at end of file