docs: add Skills.sh AI Skill page and register route by lucas-spin · Pull Request #29 · TypeComposer/docs

lucas-spin · 2026-06-12T13:34:45Z

Summary

Adds documentation for the TypeComposer Agent Skill on Skills.sh and wires it into the sidebar navigation and router.

Files changed

File	Change
`content/skills-sh.mdx`	New / rewritten — Agent Skills documentation page (Railway-style structure)
`src/assets/data.json`	Insert `"Skills.sh AI Skill"` immediately after `"Getting Started"` in the Introduction section
`src/router/router.ts`	Add `{ path: "skills-sh", component: BaseView }` child route under `/docs`

What the Skills.sh page covers (after rewrite)

The page follows the concise, section-driven layout of Railway's Agent Skills docs:

What are agent skills? — open format, agentskills.io spec, SKILL.md mechanics
Supported tools — Claude Code, OpenAI Codex, Cursor, and other Agent Skills-compatible tools (generic, no overclaiming)
Installation — exact npx skills add TypeComposer/skill command
The TypeComposer skill — route-first design, what it knows about the framework
Workflow coverage — table of every supported task (scaffold, component model, PRs, docs, tests, SSR/plugin investigation, roadmap alignment)
Source — link to the open-source GitHub repo

Roadmap alignment

Docs / Release 1.0 — community tooling and contributor resources.

Validation

npm install ✅ (clean, no blocking errors)
npm run build ✅ vite build — ✓ 2404 modules transformed, built in 11.00s, exit 0

Only advisory warnings (chunk size hint, browser data age) — no errors.

Reviewer

@zico15 — please review when you get a chance. Happy to adjust copy or sidebar placement based on your preferences.

- 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).

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).

@zico15

… URLs SEO P0 follow-up to PRs #29–#31. Problem: hash routing (/#/docs/skills) is not indexable by search engines because the fragment is never sent to the server. Direct deep-links also 404 without a server-side SPA fallback. Changes: - src/router/router.ts: history: "hash" → history: "browser" — enables clean URLs like /docs/skills, /docs/getting-started, /playground - vite.config.js: base: "./" → base: "/" — absolute asset paths prevent broken asset loads when navigating to nested routes (e.g. /docs/skills) - public/.htaccess: improve comments; SPA fallback rule was already correct (rewrite all non-file/non-dir requests to /index.html) and remains unchanged in logic — confirmed present before this PR - src/utils/seo.ts: add per-route canonical <link> injection (setCanonical); now meaningful because each route has a real URL; updated Router description to remove "hash" reference; root canonical in index.html stays https://typecomposer.com/ - public/sitemap.xml: strip /#/ from all 29 URLs (e.g. /#/docs/skills → /docs/skills, /#/playground → /playground) - public/llms.txt: strip /#/ from all 29 doc links; update Router key concept description to reference browser history mode - index.html: update JSON-LD SearchAction target from /#/docs/… to /docs/… Hosting note (⚠ must verify after deploy): The .htaccess SPA fallback was already present in the repo (added before PR #31) and is confirmed to contain the correct RewriteRule. Direct deep-link indexability (e.g. https://typecomposer.com/docs/skills returning 200 not 404) requires the Apache server to honour this .htaccess. Test with: curl -I https://typecomposer.com/docs/skills Expected: HTTP/2 200, not 301/302/404. Build: npm run build — ✓ 2405 modules, no errors Reviewer: @zico15

@zico15

…e URLs (#32) ## SEO P0 — Clean URLs via Browser History Routing Follow-up to #29, #30, #31. ### Problem Hash routing (`/#/docs/skills`) is not indexable by search engines — the fragment after `#` is never sent to the server, so Googlebot sees only `https://typecomposer.com/` for every page. Direct deep-links to `/docs/skills` also 404 without a proper SPA fallback. This means the sitemap, per-route canonicals, and per-page meta added in #31 cannot deliver their full SEO value. ### Solution Switch `Router.create` from `history: "hash"` to `history: "browser"` (HTML5 `pushState`). The server-side SPA fallback (`.htaccess`) was **already present in the repo** before this PR and contains the correct `RewriteRule ^.*$ /index.html [L,QSA]` — so direct deep-links will be served correctly on the Apache-hosted production site once this PR is merged and deployed. --- ### Files Changed (7) | File | Change | |------|--------| | `src/router/router.ts` | `history: "hash"` → `history: "browser"` | | `vite.config.js` | `base: "./"` → `base: "/"` — absolute asset paths prevent broken JS/CSS loads when a user navigates directly to a nested route like `/docs/skills` (relative `./assets/` would resolve to `/docs/assets/`) | | `src/utils/seo.ts` | `updatePageMeta()` updates `<title>` and `<meta name="description">` per route. Runtime `setCanonical()` workaround **removed** — the static root canonical in `index.html` covers the home route, and `sitemap.xml` provides authoritative clean-URL canonicals for all 29 pages without requiring JS. | | `public/sitemap.xml` | Strip `#/` from all 29 URLs (`/#/docs/skills` → `/docs/skills`, `/#/playground` → `/playground`) | | `public/llms.txt` | Same URL migration for all 29 doc links; Router key concept updated to reference `history: "browser"` | | `index.html` | JSON-LD `SearchAction.target` updated from `/#/docs/{search_term_string}` → `/docs/{search_term_string}`; canonical comment tidied | | `public/.htaccess` | Comments improved for clarity; **rewrite rule logic unchanged** — it was already correct | --- ### Build Validation (commit 2) ``` npm run build ✓ 2405 modules transformed — no errors, no type errors ``` ``` dist/.htaccess ✓ present (copied from public/) dist/sitemap.xml ✓ 0 hash URLs remaining dist/llms.txt ✓ 0 hash URLs remaining dist/index.html ✓ assets load from /assets/* (absolute paths) dist/index.html ✓ root canonical <https://typecomposer.com/> present src/utils/seo.ts ✓ setCanonical() removed src/utils/seo.ts ✓ CANONICAL_BASE constant removed ``` --- ### ⚠️ Hosting Verification Required Before Release The `.htaccess` SPA fallback must be honoured by the production Apache server. Please test after deploy: ```bash # Direct deep-link must return HTTP 200, not 301/302/404 curl -I https://typecomposer.com/docs/skills # Expected: HTTP/2 200 curl -I https://typecomposer.com/docs/getting-started # Expected: HTTP/2 200 curl -I https://typecomposer.com/playground # Expected: HTTP/2 200 # Assets must still load correctly curl -I https://typecomposer.com/typecomposer.svg # Expected: HTTP/2 200 curl -I https://typecomposer.com/sitemap.xml # Expected: HTTP/2 200 ``` If the Apache server requires `AllowOverride All` in its vhost config, that must be enabled separately by the hosting admin. If `.htaccess` is not supported, a `_redirects` (Netlify) or `vercel.json` equivalent would be needed — but the existing `.htaccess` confirms Apache is the target host. --- ### /docs/skills → Agent Skills ✓ Route `docs/skills` maps to `BaseView` and `PAGE_META["docs/skills"]` is unchanged: - Title: **Agent Skills | TypeComposer** - Description: _Use TypeComposer to build AI agent skills…_ --- cc @zico15

lucas-spin · 2026-06-12T13:34:45Z

Summary

Adds documentation for the TypeComposer Agent Skill on Skills.sh and wires it into the sidebar navigation and router.

Files changed

File	Change
`content/skills-sh.mdx`	New / rewritten — Agent Skills documentation page (Railway-style structure)
`src/assets/data.json`	Insert `"Skills.sh AI Skill"` immediately after `"Getting Started"` in the Introduction section
`src/router/router.ts`	Add `{ path: "skills-sh", component: BaseView }` child route under `/docs`

What the Skills.sh page covers (after rewrite)

The page follows the concise, section-driven layout of Railway's Agent Skills docs:

What are agent skills? — open format, agentskills.io spec, SKILL.md mechanics
Supported tools — Claude Code, OpenAI Codex, Cursor, and other Agent Skills-compatible tools (generic, no overclaiming)
Installation — exact npx skills add TypeComposer/skill command
The TypeComposer skill — route-first design, what it knows about the framework
Workflow coverage — table of every supported task (scaffold, component model, PRs, docs, tests, SSR/plugin investigation, roadmap alignment)
Source — link to the open-source GitHub repo

Roadmap alignment

Docs / Release 1.0 — community tooling and contributor resources.

Validation

npm install ✅ (clean, no blocking errors)
npm run build ✅ vite build — ✓ 2404 modules transformed, built in 11.00s, exit 0

Only advisory warnings (chunk size hint, browser data age) — no errors.

Reviewer

@zico15 — please review when you get a chance. Happy to adjust copy or sidebar placement based on your preferences.

- 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).

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).

@zico15

… URLs SEO P0 follow-up to PRs #29–#31. Problem: hash routing (/#/docs/skills) is not indexable by search engines because the fragment is never sent to the server. Direct deep-links also 404 without a server-side SPA fallback. Changes: - src/router/router.ts: history: "hash" → history: "browser" — enables clean URLs like /docs/skills, /docs/getting-started, /playground - vite.config.js: base: "./" → base: "/" — absolute asset paths prevent broken asset loads when navigating to nested routes (e.g. /docs/skills) - public/.htaccess: improve comments; SPA fallback rule was already correct (rewrite all non-file/non-dir requests to /index.html) and remains unchanged in logic — confirmed present before this PR - src/utils/seo.ts: add per-route canonical <link> injection (setCanonical); now meaningful because each route has a real URL; updated Router description to remove "hash" reference; root canonical in index.html stays https://typecomposer.com/ - public/sitemap.xml: strip /#/ from all 29 URLs (e.g. /#/docs/skills → /docs/skills, /#/playground → /playground) - public/llms.txt: strip /#/ from all 29 doc links; update Router key concept description to reference browser history mode - index.html: update JSON-LD SearchAction target from /#/docs/… to /docs/… Hosting note (⚠ must verify after deploy): The .htaccess SPA fallback was already present in the repo (added before PR #31) and is confirmed to contain the correct RewriteRule. Direct deep-link indexability (e.g. https://typecomposer.com/docs/skills returning 200 not 404) requires the Apache server to honour this .htaccess. Test with: curl -I https://typecomposer.com/docs/skills Expected: HTTP/2 200, not 301/302/404. Build: npm run build — ✓ 2405 modules, no errors Reviewer: @zico15

@zico15

…e URLs (#32) ## SEO P0 — Clean URLs via Browser History Routing Follow-up to #29, #30, #31. ### Problem Hash routing (`/#/docs/skills`) is not indexable by search engines — the fragment after `#` is never sent to the server, so Googlebot sees only `https://typecomposer.com/` for every page. Direct deep-links to `/docs/skills` also 404 without a proper SPA fallback. This means the sitemap, per-route canonicals, and per-page meta added in #31 cannot deliver their full SEO value. ### Solution Switch `Router.create` from `history: "hash"` to `history: "browser"` (HTML5 `pushState`). The server-side SPA fallback (`.htaccess`) was **already present in the repo** before this PR and contains the correct `RewriteRule ^.*$ /index.html [L,QSA]` — so direct deep-links will be served correctly on the Apache-hosted production site once this PR is merged and deployed. --- ### Files Changed (7) | File | Change | |------|--------| | `src/router/router.ts` | `history: "hash"` → `history: "browser"` | | `vite.config.js` | `base: "./"` → `base: "/"` — absolute asset paths prevent broken JS/CSS loads when a user navigates directly to a nested route like `/docs/skills` (relative `./assets/` would resolve to `/docs/assets/`) | | `src/utils/seo.ts` | `updatePageMeta()` updates `<title>` and `<meta name="description">` per route. Runtime `setCanonical()` workaround **removed** — the static root canonical in `index.html` covers the home route, and `sitemap.xml` provides authoritative clean-URL canonicals for all 29 pages without requiring JS. | | `public/sitemap.xml` | Strip `#/` from all 29 URLs (`/#/docs/skills` → `/docs/skills`, `/#/playground` → `/playground`) | | `public/llms.txt` | Same URL migration for all 29 doc links; Router key concept updated to reference `history: "browser"` | | `index.html` | JSON-LD `SearchAction.target` updated from `/#/docs/{search_term_string}` → `/docs/{search_term_string}`; canonical comment tidied | | `public/.htaccess` | Comments improved for clarity; **rewrite rule logic unchanged** — it was already correct | --- ### Build Validation (commit 2) ``` npm run build ✓ 2405 modules transformed — no errors, no type errors ``` ``` dist/.htaccess ✓ present (copied from public/) dist/sitemap.xml ✓ 0 hash URLs remaining dist/llms.txt ✓ 0 hash URLs remaining dist/index.html ✓ assets load from /assets/* (absolute paths) dist/index.html ✓ root canonical <https://typecomposer.com/> present src/utils/seo.ts ✓ setCanonical() removed src/utils/seo.ts ✓ CANONICAL_BASE constant removed ``` --- ### ⚠️ Hosting Verification Required Before Release The `.htaccess` SPA fallback must be honoured by the production Apache server. Please test after deploy: ```bash # Direct deep-link must return HTTP 200, not 301/302/404 curl -I https://typecomposer.com/docs/skills # Expected: HTTP/2 200 curl -I https://typecomposer.com/docs/getting-started # Expected: HTTP/2 200 curl -I https://typecomposer.com/playground # Expected: HTTP/2 200 # Assets must still load correctly curl -I https://typecomposer.com/typecomposer.svg # Expected: HTTP/2 200 curl -I https://typecomposer.com/sitemap.xml # Expected: HTTP/2 200 ``` If the Apache server requires `AllowOverride All` in its vhost config, that must be enabled separately by the hosting admin. If `.htaccess` is not supported, a `_redirects` (Netlify) or `vercel.json` equivalent would be needed — but the existing `.htaccess` confirms Apache is the target host. --- ### /docs/skills → Agent Skills ✓ Route `docs/skills` maps to `BaseView` and `PAGE_META["docs/skills"]` is unchanged: - Title: **Agent Skills | TypeComposer** - Description: _Use TypeComposer to build AI agent skills…_ --- cc @zico15

lucas-spin · 2026-06-12T13:34:45Z

Summary

Adds documentation for the TypeComposer Agent Skill on Skills.sh and wires it into the sidebar navigation and router.

Files changed

File	Change
`content/skills-sh.mdx`	New / rewritten — Agent Skills documentation page (Railway-style structure)
`src/assets/data.json`	Insert `"Skills.sh AI Skill"` immediately after `"Getting Started"` in the Introduction section
`src/router/router.ts`	Add `{ path: "skills-sh", component: BaseView }` child route under `/docs`

What the Skills.sh page covers (after rewrite)

The page follows the concise, section-driven layout of Railway's Agent Skills docs:

What are agent skills? — open format, agentskills.io spec, SKILL.md mechanics
Supported tools — Claude Code, OpenAI Codex, Cursor, and other Agent Skills-compatible tools (generic, no overclaiming)
Installation — exact npx skills add TypeComposer/skill command
The TypeComposer skill — route-first design, what it knows about the framework
Workflow coverage — table of every supported task (scaffold, component model, PRs, docs, tests, SSR/plugin investigation, roadmap alignment)
Source — link to the open-source GitHub repo

Roadmap alignment

Docs / Release 1.0 — community tooling and contributor resources.

Validation

npm install ✅ (clean, no blocking errors)
npm run build ✅ vite build — ✓ 2404 modules transformed, built in 11.00s, exit 0

Only advisory warnings (chunk size hint, browser data age) — no errors.

Reviewer

@zico15 — please review when you get a chance. Happy to adjust copy or sidebar placement based on your preferences.

- 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).

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).

@zico15

… URLs SEO P0 follow-up to PRs #29–#31. Problem: hash routing (/#/docs/skills) is not indexable by search engines because the fragment is never sent to the server. Direct deep-links also 404 without a server-side SPA fallback. Changes: - src/router/router.ts: history: "hash" → history: "browser" — enables clean URLs like /docs/skills, /docs/getting-started, /playground - vite.config.js: base: "./" → base: "/" — absolute asset paths prevent broken asset loads when navigating to nested routes (e.g. /docs/skills) - public/.htaccess: improve comments; SPA fallback rule was already correct (rewrite all non-file/non-dir requests to /index.html) and remains unchanged in logic — confirmed present before this PR - src/utils/seo.ts: add per-route canonical <link> injection (setCanonical); now meaningful because each route has a real URL; updated Router description to remove "hash" reference; root canonical in index.html stays https://typecomposer.com/ - public/sitemap.xml: strip /#/ from all 29 URLs (e.g. /#/docs/skills → /docs/skills, /#/playground → /playground) - public/llms.txt: strip /#/ from all 29 doc links; update Router key concept description to reference browser history mode - index.html: update JSON-LD SearchAction target from /#/docs/… to /docs/… Hosting note (⚠ must verify after deploy): The .htaccess SPA fallback was already present in the repo (added before PR #31) and is confirmed to contain the correct RewriteRule. Direct deep-link indexability (e.g. https://typecomposer.com/docs/skills returning 200 not 404) requires the Apache server to honour this .htaccess. Test with: curl -I https://typecomposer.com/docs/skills Expected: HTTP/2 200, not 301/302/404. Build: npm run build — ✓ 2405 modules, no errors Reviewer: @zico15

@zico15

…e URLs (#32) ## SEO P0 — Clean URLs via Browser History Routing Follow-up to #29, #30, #31. ### Problem Hash routing (`/#/docs/skills`) is not indexable by search engines — the fragment after `#` is never sent to the server, so Googlebot sees only `https://typecomposer.com/` for every page. Direct deep-links to `/docs/skills` also 404 without a proper SPA fallback. This means the sitemap, per-route canonicals, and per-page meta added in #31 cannot deliver their full SEO value. ### Solution Switch `Router.create` from `history: "hash"` to `history: "browser"` (HTML5 `pushState`). The server-side SPA fallback (`.htaccess`) was **already present in the repo** before this PR and contains the correct `RewriteRule ^.*$ /index.html [L,QSA]` — so direct deep-links will be served correctly on the Apache-hosted production site once this PR is merged and deployed. --- ### Files Changed (7) | File | Change | |------|--------| | `src/router/router.ts` | `history: "hash"` → `history: "browser"` | | `vite.config.js` | `base: "./"` → `base: "/"` — absolute asset paths prevent broken JS/CSS loads when a user navigates directly to a nested route like `/docs/skills` (relative `./assets/` would resolve to `/docs/assets/`) | | `src/utils/seo.ts` | `updatePageMeta()` updates `<title>` and `<meta name="description">` per route. Runtime `setCanonical()` workaround **removed** — the static root canonical in `index.html` covers the home route, and `sitemap.xml` provides authoritative clean-URL canonicals for all 29 pages without requiring JS. | | `public/sitemap.xml` | Strip `#/` from all 29 URLs (`/#/docs/skills` → `/docs/skills`, `/#/playground` → `/playground`) | | `public/llms.txt` | Same URL migration for all 29 doc links; Router key concept updated to reference `history: "browser"` | | `index.html` | JSON-LD `SearchAction.target` updated from `/#/docs/{search_term_string}` → `/docs/{search_term_string}`; canonical comment tidied | | `public/.htaccess` | Comments improved for clarity; **rewrite rule logic unchanged** — it was already correct | --- ### Build Validation (commit 2) ``` npm run build ✓ 2405 modules transformed — no errors, no type errors ``` ``` dist/.htaccess ✓ present (copied from public/) dist/sitemap.xml ✓ 0 hash URLs remaining dist/llms.txt ✓ 0 hash URLs remaining dist/index.html ✓ assets load from /assets/* (absolute paths) dist/index.html ✓ root canonical <https://typecomposer.com/> present src/utils/seo.ts ✓ setCanonical() removed src/utils/seo.ts ✓ CANONICAL_BASE constant removed ``` --- ### ⚠️ Hosting Verification Required Before Release The `.htaccess` SPA fallback must be honoured by the production Apache server. Please test after deploy: ```bash # Direct deep-link must return HTTP 200, not 301/302/404 curl -I https://typecomposer.com/docs/skills # Expected: HTTP/2 200 curl -I https://typecomposer.com/docs/getting-started # Expected: HTTP/2 200 curl -I https://typecomposer.com/playground # Expected: HTTP/2 200 # Assets must still load correctly curl -I https://typecomposer.com/typecomposer.svg # Expected: HTTP/2 200 curl -I https://typecomposer.com/sitemap.xml # Expected: HTTP/2 200 ``` If the Apache server requires `AllowOverride All` in its vhost config, that must be enabled separately by the hosting admin. If `.htaccess` is not supported, a `_redirects` (Netlify) or `vercel.json` equivalent would be needed — but the existing `.htaccess` confirms Apache is the target host. --- ### /docs/skills → Agent Skills ✓ Route `docs/skills` maps to `BaseView` and `PAGE_META["docs/skills"]` is unchanged: - Title: **Agent Skills | TypeComposer** - Description: _Use TypeComposer to build AI agent skills…_ --- cc @zico15

lucas-spin · 2026-06-12T13:34:45Z

Summary

Adds documentation for the TypeComposer Agent Skill on Skills.sh and wires it into the sidebar navigation and router.

Files changed

File	Change
`content/skills-sh.mdx`	New / rewritten — Agent Skills documentation page (Railway-style structure)
`src/assets/data.json`	Insert `"Skills.sh AI Skill"` immediately after `"Getting Started"` in the Introduction section
`src/router/router.ts`	Add `{ path: "skills-sh", component: BaseView }` child route under `/docs`

What the Skills.sh page covers (after rewrite)

The page follows the concise, section-driven layout of Railway's Agent Skills docs:

What are agent skills? — open format, agentskills.io spec, SKILL.md mechanics
Supported tools — Claude Code, OpenAI Codex, Cursor, and other Agent Skills-compatible tools (generic, no overclaiming)
Installation — exact npx skills add TypeComposer/skill command
The TypeComposer skill — route-first design, what it knows about the framework
Workflow coverage — table of every supported task (scaffold, component model, PRs, docs, tests, SSR/plugin investigation, roadmap alignment)
Source — link to the open-source GitHub repo

Roadmap alignment

Docs / Release 1.0 — community tooling and contributor resources.

Validation

npm install ✅ (clean, no blocking errors)
npm run build ✅ vite build — ✓ 2404 modules transformed, built in 11.00s, exit 0

Only advisory warnings (chunk size hint, browser data age) — no errors.

Reviewer

@zico15 — please review when you get a chance. Happy to adjust copy or sidebar placement based on your preferences.

- 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).

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).

@zico15

… URLs SEO P0 follow-up to PRs #29–#31. Problem: hash routing (/#/docs/skills) is not indexable by search engines because the fragment is never sent to the server. Direct deep-links also 404 without a server-side SPA fallback. Changes: - src/router/router.ts: history: "hash" → history: "browser" — enables clean URLs like /docs/skills, /docs/getting-started, /playground - vite.config.js: base: "./" → base: "/" — absolute asset paths prevent broken asset loads when navigating to nested routes (e.g. /docs/skills) - public/.htaccess: improve comments; SPA fallback rule was already correct (rewrite all non-file/non-dir requests to /index.html) and remains unchanged in logic — confirmed present before this PR - src/utils/seo.ts: add per-route canonical <link> injection (setCanonical); now meaningful because each route has a real URL; updated Router description to remove "hash" reference; root canonical in index.html stays https://typecomposer.com/ - public/sitemap.xml: strip /#/ from all 29 URLs (e.g. /#/docs/skills → /docs/skills, /#/playground → /playground) - public/llms.txt: strip /#/ from all 29 doc links; update Router key concept description to reference browser history mode - index.html: update JSON-LD SearchAction target from /#/docs/… to /docs/… Hosting note (⚠ must verify after deploy): The .htaccess SPA fallback was already present in the repo (added before PR #31) and is confirmed to contain the correct RewriteRule. Direct deep-link indexability (e.g. https://typecomposer.com/docs/skills returning 200 not 404) requires the Apache server to honour this .htaccess. Test with: curl -I https://typecomposer.com/docs/skills Expected: HTTP/2 200, not 301/302/404. Build: npm run build — ✓ 2405 modules, no errors Reviewer: @zico15

@zico15

…e URLs (#32) ## SEO P0 — Clean URLs via Browser History Routing Follow-up to #29, #30, #31. ### Problem Hash routing (`/#/docs/skills`) is not indexable by search engines — the fragment after `#` is never sent to the server, so Googlebot sees only `https://typecomposer.com/` for every page. Direct deep-links to `/docs/skills` also 404 without a proper SPA fallback. This means the sitemap, per-route canonicals, and per-page meta added in #31 cannot deliver their full SEO value. ### Solution Switch `Router.create` from `history: "hash"` to `history: "browser"` (HTML5 `pushState`). The server-side SPA fallback (`.htaccess`) was **already present in the repo** before this PR and contains the correct `RewriteRule ^.*$ /index.html [L,QSA]` — so direct deep-links will be served correctly on the Apache-hosted production site once this PR is merged and deployed. --- ### Files Changed (7) | File | Change | |------|--------| | `src/router/router.ts` | `history: "hash"` → `history: "browser"` | | `vite.config.js` | `base: "./"` → `base: "/"` — absolute asset paths prevent broken JS/CSS loads when a user navigates directly to a nested route like `/docs/skills` (relative `./assets/` would resolve to `/docs/assets/`) | | `src/utils/seo.ts` | `updatePageMeta()` updates `<title>` and `<meta name="description">` per route. Runtime `setCanonical()` workaround **removed** — the static root canonical in `index.html` covers the home route, and `sitemap.xml` provides authoritative clean-URL canonicals for all 29 pages without requiring JS. | | `public/sitemap.xml` | Strip `#/` from all 29 URLs (`/#/docs/skills` → `/docs/skills`, `/#/playground` → `/playground`) | | `public/llms.txt` | Same URL migration for all 29 doc links; Router key concept updated to reference `history: "browser"` | | `index.html` | JSON-LD `SearchAction.target` updated from `/#/docs/{search_term_string}` → `/docs/{search_term_string}`; canonical comment tidied | | `public/.htaccess` | Comments improved for clarity; **rewrite rule logic unchanged** — it was already correct | --- ### Build Validation (commit 2) ``` npm run build ✓ 2405 modules transformed — no errors, no type errors ``` ``` dist/.htaccess ✓ present (copied from public/) dist/sitemap.xml ✓ 0 hash URLs remaining dist/llms.txt ✓ 0 hash URLs remaining dist/index.html ✓ assets load from /assets/* (absolute paths) dist/index.html ✓ root canonical <https://typecomposer.com/> present src/utils/seo.ts ✓ setCanonical() removed src/utils/seo.ts ✓ CANONICAL_BASE constant removed ``` --- ### ⚠️ Hosting Verification Required Before Release The `.htaccess` SPA fallback must be honoured by the production Apache server. Please test after deploy: ```bash # Direct deep-link must return HTTP 200, not 301/302/404 curl -I https://typecomposer.com/docs/skills # Expected: HTTP/2 200 curl -I https://typecomposer.com/docs/getting-started # Expected: HTTP/2 200 curl -I https://typecomposer.com/playground # Expected: HTTP/2 200 # Assets must still load correctly curl -I https://typecomposer.com/typecomposer.svg # Expected: HTTP/2 200 curl -I https://typecomposer.com/sitemap.xml # Expected: HTTP/2 200 ``` If the Apache server requires `AllowOverride All` in its vhost config, that must be enabled separately by the hosting admin. If `.htaccess` is not supported, a `_redirects` (Netlify) or `vercel.json` equivalent would be needed — but the existing `.htaccess` confirms Apache is the target host. --- ### /docs/skills → Agent Skills ✓ Route `docs/skills` maps to `BaseView` and `PAGE_META["docs/skills"]` is unchanged: - Title: **Agent Skills | TypeComposer** - Description: _Use TypeComposer to build AI agent skills…_ --- cc @zico15

lucas-spin · 2026-06-12T13:34:45Z

Summary

Adds documentation for the TypeComposer Agent Skill on Skills.sh and wires it into the sidebar navigation and router.

Files changed

File	Change
`content/skills-sh.mdx`	New / rewritten — Agent Skills documentation page (Railway-style structure)
`src/assets/data.json`	Insert `"Skills.sh AI Skill"` immediately after `"Getting Started"` in the Introduction section
`src/router/router.ts`	Add `{ path: "skills-sh", component: BaseView }` child route under `/docs`

What the Skills.sh page covers (after rewrite)

The page follows the concise, section-driven layout of Railway's Agent Skills docs:

What are agent skills? — open format, agentskills.io spec, SKILL.md mechanics
Supported tools — Claude Code, OpenAI Codex, Cursor, and other Agent Skills-compatible tools (generic, no overclaiming)
Installation — exact npx skills add TypeComposer/skill command
The TypeComposer skill — route-first design, what it knows about the framework
Workflow coverage — table of every supported task (scaffold, component model, PRs, docs, tests, SSR/plugin investigation, roadmap alignment)
Source — link to the open-source GitHub repo

Roadmap alignment

Docs / Release 1.0 — community tooling and contributor resources.

Validation

npm install ✅ (clean, no blocking errors)
npm run build ✅ vite build — ✓ 2404 modules transformed, built in 11.00s, exit 0

Only advisory warnings (chunk size hint, browser data age) — no errors.

Reviewer

@zico15 — please review when you get a chance. Happy to adjust copy or sidebar placement based on your preferences.

- 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).

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).

@zico15

… URLs SEO P0 follow-up to PRs #29–#31. Problem: hash routing (/#/docs/skills) is not indexable by search engines because the fragment is never sent to the server. Direct deep-links also 404 without a server-side SPA fallback. Changes: - src/router/router.ts: history: "hash" → history: "browser" — enables clean URLs like /docs/skills, /docs/getting-started, /playground - vite.config.js: base: "./" → base: "/" — absolute asset paths prevent broken asset loads when navigating to nested routes (e.g. /docs/skills) - public/.htaccess: improve comments; SPA fallback rule was already correct (rewrite all non-file/non-dir requests to /index.html) and remains unchanged in logic — confirmed present before this PR - src/utils/seo.ts: add per-route canonical <link> injection (setCanonical); now meaningful because each route has a real URL; updated Router description to remove "hash" reference; root canonical in index.html stays https://typecomposer.com/ - public/sitemap.xml: strip /#/ from all 29 URLs (e.g. /#/docs/skills → /docs/skills, /#/playground → /playground) - public/llms.txt: strip /#/ from all 29 doc links; update Router key concept description to reference browser history mode - index.html: update JSON-LD SearchAction target from /#/docs/… to /docs/… Hosting note (⚠ must verify after deploy): The .htaccess SPA fallback was already present in the repo (added before PR #31) and is confirmed to contain the correct RewriteRule. Direct deep-link indexability (e.g. https://typecomposer.com/docs/skills returning 200 not 404) requires the Apache server to honour this .htaccess. Test with: curl -I https://typecomposer.com/docs/skills Expected: HTTP/2 200, not 301/302/404. Build: npm run build — ✓ 2405 modules, no errors Reviewer: @zico15

@zico15

…e URLs (#32) ## SEO P0 — Clean URLs via Browser History Routing Follow-up to #29, #30, #31. ### Problem Hash routing (`/#/docs/skills`) is not indexable by search engines — the fragment after `#` is never sent to the server, so Googlebot sees only `https://typecomposer.com/` for every page. Direct deep-links to `/docs/skills` also 404 without a proper SPA fallback. This means the sitemap, per-route canonicals, and per-page meta added in #31 cannot deliver their full SEO value. ### Solution Switch `Router.create` from `history: "hash"` to `history: "browser"` (HTML5 `pushState`). The server-side SPA fallback (`.htaccess`) was **already present in the repo** before this PR and contains the correct `RewriteRule ^.*$ /index.html [L,QSA]` — so direct deep-links will be served correctly on the Apache-hosted production site once this PR is merged and deployed. --- ### Files Changed (7) | File | Change | |------|--------| | `src/router/router.ts` | `history: "hash"` → `history: "browser"` | | `vite.config.js` | `base: "./"` → `base: "/"` — absolute asset paths prevent broken JS/CSS loads when a user navigates directly to a nested route like `/docs/skills` (relative `./assets/` would resolve to `/docs/assets/`) | | `src/utils/seo.ts` | `updatePageMeta()` updates `<title>` and `<meta name="description">` per route. Runtime `setCanonical()` workaround **removed** — the static root canonical in `index.html` covers the home route, and `sitemap.xml` provides authoritative clean-URL canonicals for all 29 pages without requiring JS. | | `public/sitemap.xml` | Strip `#/` from all 29 URLs (`/#/docs/skills` → `/docs/skills`, `/#/playground` → `/playground`) | | `public/llms.txt` | Same URL migration for all 29 doc links; Router key concept updated to reference `history: "browser"` | | `index.html` | JSON-LD `SearchAction.target` updated from `/#/docs/{search_term_string}` → `/docs/{search_term_string}`; canonical comment tidied | | `public/.htaccess` | Comments improved for clarity; **rewrite rule logic unchanged** — it was already correct | --- ### Build Validation (commit 2) ``` npm run build ✓ 2405 modules transformed — no errors, no type errors ``` ``` dist/.htaccess ✓ present (copied from public/) dist/sitemap.xml ✓ 0 hash URLs remaining dist/llms.txt ✓ 0 hash URLs remaining dist/index.html ✓ assets load from /assets/* (absolute paths) dist/index.html ✓ root canonical <https://typecomposer.com/> present src/utils/seo.ts ✓ setCanonical() removed src/utils/seo.ts ✓ CANONICAL_BASE constant removed ``` --- ### ⚠️ Hosting Verification Required Before Release The `.htaccess` SPA fallback must be honoured by the production Apache server. Please test after deploy: ```bash # Direct deep-link must return HTTP 200, not 301/302/404 curl -I https://typecomposer.com/docs/skills # Expected: HTTP/2 200 curl -I https://typecomposer.com/docs/getting-started # Expected: HTTP/2 200 curl -I https://typecomposer.com/playground # Expected: HTTP/2 200 # Assets must still load correctly curl -I https://typecomposer.com/typecomposer.svg # Expected: HTTP/2 200 curl -I https://typecomposer.com/sitemap.xml # Expected: HTTP/2 200 ``` If the Apache server requires `AllowOverride All` in its vhost config, that must be enabled separately by the hosting admin. If `.htaccess` is not supported, a `_redirects` (Netlify) or `vercel.json` equivalent would be needed — but the existing `.htaccess` confirms Apache is the target host. --- ### /docs/skills → Agent Skills ✓ Route `docs/skills` maps to `BaseView` and `PAGE_META["docs/skills"]` is unchanged: - Title: **Agent Skills | TypeComposer** - Description: _Use TypeComposer to build AI agent skills…_ --- cc @zico15

lucas-spin · 2026-06-12T13:34:45Z

Summary

Adds documentation for the TypeComposer Agent Skill on Skills.sh and wires it into the sidebar navigation and router.

Files changed

File	Change
`content/skills-sh.mdx`	New / rewritten — Agent Skills documentation page (Railway-style structure)
`src/assets/data.json`	Insert `"Skills.sh AI Skill"` immediately after `"Getting Started"` in the Introduction section
`src/router/router.ts`	Add `{ path: "skills-sh", component: BaseView }` child route under `/docs`

What the Skills.sh page covers (after rewrite)

The page follows the concise, section-driven layout of Railway's Agent Skills docs:

What are agent skills? — open format, agentskills.io spec, SKILL.md mechanics
Supported tools — Claude Code, OpenAI Codex, Cursor, and other Agent Skills-compatible tools (generic, no overclaiming)
Installation — exact npx skills add TypeComposer/skill command
The TypeComposer skill — route-first design, what it knows about the framework
Workflow coverage — table of every supported task (scaffold, component model, PRs, docs, tests, SSR/plugin investigation, roadmap alignment)
Source — link to the open-source GitHub repo

Roadmap alignment

Docs / Release 1.0 — community tooling and contributor resources.

Validation

npm install ✅ (clean, no blocking errors)
npm run build ✅ vite build — ✓ 2404 modules transformed, built in 11.00s, exit 0

Only advisory warnings (chunk size hint, browser data age) — no errors.

Reviewer

@zico15 — please review when you get a chance. Happy to adjust copy or sidebar placement based on your preferences.

- 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).

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).

@zico15

… URLs SEO P0 follow-up to PRs #29–#31. Problem: hash routing (/#/docs/skills) is not indexable by search engines because the fragment is never sent to the server. Direct deep-links also 404 without a server-side SPA fallback. Changes: - src/router/router.ts: history: "hash" → history: "browser" — enables clean URLs like /docs/skills, /docs/getting-started, /playground - vite.config.js: base: "./" → base: "/" — absolute asset paths prevent broken asset loads when navigating to nested routes (e.g. /docs/skills) - public/.htaccess: improve comments; SPA fallback rule was already correct (rewrite all non-file/non-dir requests to /index.html) and remains unchanged in logic — confirmed present before this PR - src/utils/seo.ts: add per-route canonical <link> injection (setCanonical); now meaningful because each route has a real URL; updated Router description to remove "hash" reference; root canonical in index.html stays https://typecomposer.com/ - public/sitemap.xml: strip /#/ from all 29 URLs (e.g. /#/docs/skills → /docs/skills, /#/playground → /playground) - public/llms.txt: strip /#/ from all 29 doc links; update Router key concept description to reference browser history mode - index.html: update JSON-LD SearchAction target from /#/docs/… to /docs/… Hosting note (⚠ must verify after deploy): The .htaccess SPA fallback was already present in the repo (added before PR #31) and is confirmed to contain the correct RewriteRule. Direct deep-link indexability (e.g. https://typecomposer.com/docs/skills returning 200 not 404) requires the Apache server to honour this .htaccess. Test with: curl -I https://typecomposer.com/docs/skills Expected: HTTP/2 200, not 301/302/404. Build: npm run build — ✓ 2405 modules, no errors Reviewer: @zico15

@zico15

…e URLs (#32) ## SEO P0 — Clean URLs via Browser History Routing Follow-up to #29, #30, #31. ### Problem Hash routing (`/#/docs/skills`) is not indexable by search engines — the fragment after `#` is never sent to the server, so Googlebot sees only `https://typecomposer.com/` for every page. Direct deep-links to `/docs/skills` also 404 without a proper SPA fallback. This means the sitemap, per-route canonicals, and per-page meta added in #31 cannot deliver their full SEO value. ### Solution Switch `Router.create` from `history: "hash"` to `history: "browser"` (HTML5 `pushState`). The server-side SPA fallback (`.htaccess`) was **already present in the repo** before this PR and contains the correct `RewriteRule ^.*$ /index.html [L,QSA]` — so direct deep-links will be served correctly on the Apache-hosted production site once this PR is merged and deployed. --- ### Files Changed (7) | File | Change | |------|--------| | `src/router/router.ts` | `history: "hash"` → `history: "browser"` | | `vite.config.js` | `base: "./"` → `base: "/"` — absolute asset paths prevent broken JS/CSS loads when a user navigates directly to a nested route like `/docs/skills` (relative `./assets/` would resolve to `/docs/assets/`) | | `src/utils/seo.ts` | `updatePageMeta()` updates `<title>` and `<meta name="description">` per route. Runtime `setCanonical()` workaround **removed** — the static root canonical in `index.html` covers the home route, and `sitemap.xml` provides authoritative clean-URL canonicals for all 29 pages without requiring JS. | | `public/sitemap.xml` | Strip `#/` from all 29 URLs (`/#/docs/skills` → `/docs/skills`, `/#/playground` → `/playground`) | | `public/llms.txt` | Same URL migration for all 29 doc links; Router key concept updated to reference `history: "browser"` | | `index.html` | JSON-LD `SearchAction.target` updated from `/#/docs/{search_term_string}` → `/docs/{search_term_string}`; canonical comment tidied | | `public/.htaccess` | Comments improved for clarity; **rewrite rule logic unchanged** — it was already correct | --- ### Build Validation (commit 2) ``` npm run build ✓ 2405 modules transformed — no errors, no type errors ``` ``` dist/.htaccess ✓ present (copied from public/) dist/sitemap.xml ✓ 0 hash URLs remaining dist/llms.txt ✓ 0 hash URLs remaining dist/index.html ✓ assets load from /assets/* (absolute paths) dist/index.html ✓ root canonical <https://typecomposer.com/> present src/utils/seo.ts ✓ setCanonical() removed src/utils/seo.ts ✓ CANONICAL_BASE constant removed ``` --- ### ⚠️ Hosting Verification Required Before Release The `.htaccess` SPA fallback must be honoured by the production Apache server. Please test after deploy: ```bash # Direct deep-link must return HTTP 200, not 301/302/404 curl -I https://typecomposer.com/docs/skills # Expected: HTTP/2 200 curl -I https://typecomposer.com/docs/getting-started # Expected: HTTP/2 200 curl -I https://typecomposer.com/playground # Expected: HTTP/2 200 # Assets must still load correctly curl -I https://typecomposer.com/typecomposer.svg # Expected: HTTP/2 200 curl -I https://typecomposer.com/sitemap.xml # Expected: HTTP/2 200 ``` If the Apache server requires `AllowOverride All` in its vhost config, that must be enabled separately by the hosting admin. If `.htaccess` is not supported, a `_redirects` (Netlify) or `vercel.json` equivalent would be needed — but the existing `.htaccess` confirms Apache is the target host. --- ### /docs/skills → Agent Skills ✓ Route `docs/skills` maps to `BaseView` and `PAGE_META["docs/skills"]` is unchanged: - Title: **Agent Skills | TypeComposer** - Description: _Use TypeComposer to build AI agent skills…_ --- cc @zico15

lucas-spin · 2026-06-12T13:34:45Z

Summary

Adds documentation for the TypeComposer Agent Skill on Skills.sh and wires it into the sidebar navigation and router.

Files changed

File	Change
`content/skills-sh.mdx`	New / rewritten — Agent Skills documentation page (Railway-style structure)
`src/assets/data.json`	Insert `"Skills.sh AI Skill"` immediately after `"Getting Started"` in the Introduction section
`src/router/router.ts`	Add `{ path: "skills-sh", component: BaseView }` child route under `/docs`

What the Skills.sh page covers (after rewrite)

The page follows the concise, section-driven layout of Railway's Agent Skills docs:

What are agent skills? — open format, agentskills.io spec, SKILL.md mechanics
Supported tools — Claude Code, OpenAI Codex, Cursor, and other Agent Skills-compatible tools (generic, no overclaiming)
Installation — exact npx skills add TypeComposer/skill command
The TypeComposer skill — route-first design, what it knows about the framework
Workflow coverage — table of every supported task (scaffold, component model, PRs, docs, tests, SSR/plugin investigation, roadmap alignment)
Source — link to the open-source GitHub repo

Roadmap alignment

Docs / Release 1.0 — community tooling and contributor resources.

Validation

npm install ✅ (clean, no blocking errors)
npm run build ✅ vite build — ✓ 2404 modules transformed, built in 11.00s, exit 0

Only advisory warnings (chunk size hint, browser data age) — no errors.

Reviewer

@zico15 — please review when you get a chance. Happy to adjust copy or sidebar placement based on your preferences.

- 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).

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).

@zico15

… URLs SEO P0 follow-up to PRs #29–#31. Problem: hash routing (/#/docs/skills) is not indexable by search engines because the fragment is never sent to the server. Direct deep-links also 404 without a server-side SPA fallback. Changes: - src/router/router.ts: history: "hash" → history: "browser" — enables clean URLs like /docs/skills, /docs/getting-started, /playground - vite.config.js: base: "./" → base: "/" — absolute asset paths prevent broken asset loads when navigating to nested routes (e.g. /docs/skills) - public/.htaccess: improve comments; SPA fallback rule was already correct (rewrite all non-file/non-dir requests to /index.html) and remains unchanged in logic — confirmed present before this PR - src/utils/seo.ts: add per-route canonical <link> injection (setCanonical); now meaningful because each route has a real URL; updated Router description to remove "hash" reference; root canonical in index.html stays https://typecomposer.com/ - public/sitemap.xml: strip /#/ from all 29 URLs (e.g. /#/docs/skills → /docs/skills, /#/playground → /playground) - public/llms.txt: strip /#/ from all 29 doc links; update Router key concept description to reference browser history mode - index.html: update JSON-LD SearchAction target from /#/docs/… to /docs/… Hosting note (⚠ must verify after deploy): The .htaccess SPA fallback was already present in the repo (added before PR #31) and is confirmed to contain the correct RewriteRule. Direct deep-link indexability (e.g. https://typecomposer.com/docs/skills returning 200 not 404) requires the Apache server to honour this .htaccess. Test with: curl -I https://typecomposer.com/docs/skills Expected: HTTP/2 200, not 301/302/404. Build: npm run build — ✓ 2405 modules, no errors Reviewer: @zico15

@zico15

…e URLs (#32) ## SEO P0 — Clean URLs via Browser History Routing Follow-up to #29, #30, #31. ### Problem Hash routing (`/#/docs/skills`) is not indexable by search engines — the fragment after `#` is never sent to the server, so Googlebot sees only `https://typecomposer.com/` for every page. Direct deep-links to `/docs/skills` also 404 without a proper SPA fallback. This means the sitemap, per-route canonicals, and per-page meta added in #31 cannot deliver their full SEO value. ### Solution Switch `Router.create` from `history: "hash"` to `history: "browser"` (HTML5 `pushState`). The server-side SPA fallback (`.htaccess`) was **already present in the repo** before this PR and contains the correct `RewriteRule ^.*$ /index.html [L,QSA]` — so direct deep-links will be served correctly on the Apache-hosted production site once this PR is merged and deployed. --- ### Files Changed (7) | File | Change | |------|--------| | `src/router/router.ts` | `history: "hash"` → `history: "browser"` | | `vite.config.js` | `base: "./"` → `base: "/"` — absolute asset paths prevent broken JS/CSS loads when a user navigates directly to a nested route like `/docs/skills` (relative `./assets/` would resolve to `/docs/assets/`) | | `src/utils/seo.ts` | `updatePageMeta()` updates `<title>` and `<meta name="description">` per route. Runtime `setCanonical()` workaround **removed** — the static root canonical in `index.html` covers the home route, and `sitemap.xml` provides authoritative clean-URL canonicals for all 29 pages without requiring JS. | | `public/sitemap.xml` | Strip `#/` from all 29 URLs (`/#/docs/skills` → `/docs/skills`, `/#/playground` → `/playground`) | | `public/llms.txt` | Same URL migration for all 29 doc links; Router key concept updated to reference `history: "browser"` | | `index.html` | JSON-LD `SearchAction.target` updated from `/#/docs/{search_term_string}` → `/docs/{search_term_string}`; canonical comment tidied | | `public/.htaccess` | Comments improved for clarity; **rewrite rule logic unchanged** — it was already correct | --- ### Build Validation (commit 2) ``` npm run build ✓ 2405 modules transformed — no errors, no type errors ``` ``` dist/.htaccess ✓ present (copied from public/) dist/sitemap.xml ✓ 0 hash URLs remaining dist/llms.txt ✓ 0 hash URLs remaining dist/index.html ✓ assets load from /assets/* (absolute paths) dist/index.html ✓ root canonical <https://typecomposer.com/> present src/utils/seo.ts ✓ setCanonical() removed src/utils/seo.ts ✓ CANONICAL_BASE constant removed ``` --- ### ⚠️ Hosting Verification Required Before Release The `.htaccess` SPA fallback must be honoured by the production Apache server. Please test after deploy: ```bash # Direct deep-link must return HTTP 200, not 301/302/404 curl -I https://typecomposer.com/docs/skills # Expected: HTTP/2 200 curl -I https://typecomposer.com/docs/getting-started # Expected: HTTP/2 200 curl -I https://typecomposer.com/playground # Expected: HTTP/2 200 # Assets must still load correctly curl -I https://typecomposer.com/typecomposer.svg # Expected: HTTP/2 200 curl -I https://typecomposer.com/sitemap.xml # Expected: HTTP/2 200 ``` If the Apache server requires `AllowOverride All` in its vhost config, that must be enabled separately by the hosting admin. If `.htaccess` is not supported, a `_redirects` (Netlify) or `vercel.json` equivalent would be needed — but the existing `.htaccess` confirms Apache is the target host. --- ### /docs/skills → Agent Skills ✓ Route `docs/skills` maps to `BaseView` and `PAGE_META["docs/skills"]` is unchanged: - Title: **Agent Skills | TypeComposer** - Description: _Use TypeComposer to build AI agent skills…_ --- cc @zico15

lucas-spin · 2026-06-12T13:34:45Z

Summary

Adds documentation for the TypeComposer Agent Skill on Skills.sh and wires it into the sidebar navigation and router.

Files changed

File	Change
`content/skills-sh.mdx`	New / rewritten — Agent Skills documentation page (Railway-style structure)
`src/assets/data.json`	Insert `"Skills.sh AI Skill"` immediately after `"Getting Started"` in the Introduction section
`src/router/router.ts`	Add `{ path: "skills-sh", component: BaseView }` child route under `/docs`

What the Skills.sh page covers (after rewrite)

The page follows the concise, section-driven layout of Railway's Agent Skills docs:

What are agent skills? — open format, agentskills.io spec, SKILL.md mechanics
Supported tools — Claude Code, OpenAI Codex, Cursor, and other Agent Skills-compatible tools (generic, no overclaiming)
Installation — exact npx skills add TypeComposer/skill command
The TypeComposer skill — route-first design, what it knows about the framework
Workflow coverage — table of every supported task (scaffold, component model, PRs, docs, tests, SSR/plugin investigation, roadmap alignment)
Source — link to the open-source GitHub repo

Roadmap alignment

Docs / Release 1.0 — community tooling and contributor resources.

Validation

npm install ✅ (clean, no blocking errors)
npm run build ✅ vite build — ✓ 2404 modules transformed, built in 11.00s, exit 0

Only advisory warnings (chunk size hint, browser data age) — no errors.

Reviewer

@zico15 — please review when you get a chance. Happy to adjust copy or sidebar placement based on your preferences.

- 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).

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).

@zico15

… URLs SEO P0 follow-up to PRs #29–#31. Problem: hash routing (/#/docs/skills) is not indexable by search engines because the fragment is never sent to the server. Direct deep-links also 404 without a server-side SPA fallback. Changes: - src/router/router.ts: history: "hash" → history: "browser" — enables clean URLs like /docs/skills, /docs/getting-started, /playground - vite.config.js: base: "./" → base: "/" — absolute asset paths prevent broken asset loads when navigating to nested routes (e.g. /docs/skills) - public/.htaccess: improve comments; SPA fallback rule was already correct (rewrite all non-file/non-dir requests to /index.html) and remains unchanged in logic — confirmed present before this PR - src/utils/seo.ts: add per-route canonical <link> injection (setCanonical); now meaningful because each route has a real URL; updated Router description to remove "hash" reference; root canonical in index.html stays https://typecomposer.com/ - public/sitemap.xml: strip /#/ from all 29 URLs (e.g. /#/docs/skills → /docs/skills, /#/playground → /playground) - public/llms.txt: strip /#/ from all 29 doc links; update Router key concept description to reference browser history mode - index.html: update JSON-LD SearchAction target from /#/docs/… to /docs/… Hosting note (⚠ must verify after deploy): The .htaccess SPA fallback was already present in the repo (added before PR #31) and is confirmed to contain the correct RewriteRule. Direct deep-link indexability (e.g. https://typecomposer.com/docs/skills returning 200 not 404) requires the Apache server to honour this .htaccess. Test with: curl -I https://typecomposer.com/docs/skills Expected: HTTP/2 200, not 301/302/404. Build: npm run build — ✓ 2405 modules, no errors Reviewer: @zico15

@zico15

…e URLs (#32) ## SEO P0 — Clean URLs via Browser History Routing Follow-up to #29, #30, #31. ### Problem Hash routing (`/#/docs/skills`) is not indexable by search engines — the fragment after `#` is never sent to the server, so Googlebot sees only `https://typecomposer.com/` for every page. Direct deep-links to `/docs/skills` also 404 without a proper SPA fallback. This means the sitemap, per-route canonicals, and per-page meta added in #31 cannot deliver their full SEO value. ### Solution Switch `Router.create` from `history: "hash"` to `history: "browser"` (HTML5 `pushState`). The server-side SPA fallback (`.htaccess`) was **already present in the repo** before this PR and contains the correct `RewriteRule ^.*$ /index.html [L,QSA]` — so direct deep-links will be served correctly on the Apache-hosted production site once this PR is merged and deployed. --- ### Files Changed (7) | File | Change | |------|--------| | `src/router/router.ts` | `history: "hash"` → `history: "browser"` | | `vite.config.js` | `base: "./"` → `base: "/"` — absolute asset paths prevent broken JS/CSS loads when a user navigates directly to a nested route like `/docs/skills` (relative `./assets/` would resolve to `/docs/assets/`) | | `src/utils/seo.ts` | `updatePageMeta()` updates `<title>` and `<meta name="description">` per route. Runtime `setCanonical()` workaround **removed** — the static root canonical in `index.html` covers the home route, and `sitemap.xml` provides authoritative clean-URL canonicals for all 29 pages without requiring JS. | | `public/sitemap.xml` | Strip `#/` from all 29 URLs (`/#/docs/skills` → `/docs/skills`, `/#/playground` → `/playground`) | | `public/llms.txt` | Same URL migration for all 29 doc links; Router key concept updated to reference `history: "browser"` | | `index.html` | JSON-LD `SearchAction.target` updated from `/#/docs/{search_term_string}` → `/docs/{search_term_string}`; canonical comment tidied | | `public/.htaccess` | Comments improved for clarity; **rewrite rule logic unchanged** — it was already correct | --- ### Build Validation (commit 2) ``` npm run build ✓ 2405 modules transformed — no errors, no type errors ``` ``` dist/.htaccess ✓ present (copied from public/) dist/sitemap.xml ✓ 0 hash URLs remaining dist/llms.txt ✓ 0 hash URLs remaining dist/index.html ✓ assets load from /assets/* (absolute paths) dist/index.html ✓ root canonical <https://typecomposer.com/> present src/utils/seo.ts ✓ setCanonical() removed src/utils/seo.ts ✓ CANONICAL_BASE constant removed ``` --- ### ⚠️ Hosting Verification Required Before Release The `.htaccess` SPA fallback must be honoured by the production Apache server. Please test after deploy: ```bash # Direct deep-link must return HTTP 200, not 301/302/404 curl -I https://typecomposer.com/docs/skills # Expected: HTTP/2 200 curl -I https://typecomposer.com/docs/getting-started # Expected: HTTP/2 200 curl -I https://typecomposer.com/playground # Expected: HTTP/2 200 # Assets must still load correctly curl -I https://typecomposer.com/typecomposer.svg # Expected: HTTP/2 200 curl -I https://typecomposer.com/sitemap.xml # Expected: HTTP/2 200 ``` If the Apache server requires `AllowOverride All` in its vhost config, that must be enabled separately by the hosting admin. If `.htaccess` is not supported, a `_redirects` (Netlify) or `vercel.json` equivalent would be needed — but the existing `.htaccess` confirms Apache is the target host. --- ### /docs/skills → Agent Skills ✓ Route `docs/skills` maps to `BaseView` and `PAGE_META["docs/skills"]` is unchanged: - Title: **Agent Skills | TypeComposer** - Description: _Use TypeComposer to build AI agent skills…_ --- cc @zico15

lucas-spin added 2 commits June 12, 2026 13:34

joaodibba merged commit fe0d502 into TypeComposer:mainJun 12, 2026

lucas-spin mentioned this pull request Jun 12, 2026
feat(seo): migrate hash router to browser history for clean, indexable URLs #32
Merged

lucas-spin added 2 commits June 12, 2026 13:34

joaodibba merged commit fe0d502 into TypeComposer:mainJun 12, 2026

lucas-spin mentioned this pull request Jun 12, 2026
feat(seo): migrate hash router to browser history for clean, indexable URLs #32
Merged

lucas-spin added 2 commits June 12, 2026 13:34

joaodibba merged commit fe0d502 into TypeComposer:mainJun 12, 2026

lucas-spin mentioned this pull request Jun 12, 2026
feat(seo): migrate hash router to browser history for clean, indexable URLs #32
Merged

lucas-spin added 2 commits June 12, 2026 13:34

joaodibba merged commit fe0d502 into TypeComposer:mainJun 12, 2026

lucas-spin mentioned this pull request Jun 12, 2026
feat(seo): migrate hash router to browser history for clean, indexable URLs #32
Merged

lucas-spin added 2 commits June 12, 2026 13:34

joaodibba merged commit fe0d502 into TypeComposer:mainJun 12, 2026

lucas-spin mentioned this pull request Jun 12, 2026
feat(seo): migrate hash router to browser history for clean, indexable URLs #32
Merged

lucas-spin added 2 commits June 12, 2026 13:34

joaodibba merged commit fe0d502 into TypeComposer:mainJun 12, 2026

lucas-spin mentioned this pull request Jun 12, 2026
feat(seo): migrate hash router to browser history for clean, indexable URLs #32
Merged

lucas-spin added 2 commits June 12, 2026 13:34

joaodibba merged commit fe0d502 into TypeComposer:mainJun 12, 2026

lucas-spin mentioned this pull request Jun 12, 2026
feat(seo): migrate hash router to browser history for clean, indexable URLs #32
Merged

lucas-spin added 2 commits June 12, 2026 13:34

joaodibba merged commit fe0d502 into TypeComposer:mainJun 12, 2026

lucas-spin mentioned this pull request Jun 12, 2026
feat(seo): migrate hash router to browser history for clean, indexable URLs #32
Merged

Uh oh!

Conversation

lucas-spin commented Jun 12, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Files changed

What the Skills.sh page covers (after rewrite)

Roadmap alignment

Validation

Reviewer

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

lucas-spin commented Jun 12, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Files changed

What the Skills.sh page covers (after rewrite)

Roadmap alignment

Validation

Reviewer

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

lucas-spin commented Jun 12, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Files changed

What the Skills.sh page covers (after rewrite)

Roadmap alignment

Validation

Reviewer

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

lucas-spin commented Jun 12, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Files changed

What the Skills.sh page covers (after rewrite)

Roadmap alignment

Validation

Reviewer

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

lucas-spin commented Jun 12, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

lucas-spin commented Jun 12, 2026•
edited
Loading

lucas-spin commented Jun 12, 2026•
edited
Loading

lucas-spin commented Jun 12, 2026•
edited
Loading

lucas-spin commented Jun 12, 2026•
edited
Loading

lucas-spin commented Jun 12, 2026•
edited
Loading

lucas-spin commented Jun 12, 2026•
edited
Loading

lucas-spin commented Jun 12, 2026•
edited
Loading