tiankonglan/TomeWiki / .agents/skills/tomtwiki-quick-start
tomtwiki-quick-start
VerifiedTurns a fresh TomeWiki clone into a named unofficial fan wiki. Fills site identity, SEO, homepage copy, theme, and brand images from a short game brief. Use when the user names a game and wants this template customized, when Example Game placeholders remain, or when they say 建站, 快速接入, 改成自己的站, or bootstrap a guide site from this repo.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.2 KB |
| references/00-brief.md | markdown | 1.8 KB |
| references/01-env-and-worker.md | markdown | 970 B |
| references/02-identity.md | markdown | 1.8 KB |
| references/03-seo.md | markdown | 629 B |
| references/04-homepage.md | markdown | 1.2 KB |
| references/05-theme.md | markdown | 1.3 KB |
| references/06-brand-assets.md | markdown | 1.0 KB |
| references/07-checklist.md | markdown | 2.5 KB |
references/07-checklist.md
View on GitHub# Permitted paths and sign-off
## Paths this pass may write
- `.env` (copied from `.env.example`)
- `.dev.vars` (only when they need `cf:preview`)
- `wrangler.jsonc` — `name` and the `WORKER_SELF_REFERENCE` `service` must be the same slug
- `src/generated/game-config.ts`
- `src/generated/homepage.ts`
- `src/generated/site-locales.ts` — drop `scaffold-default:en-only`; extra locales only if requested
- `src/generated/visual-profile.json`
- `src/generated/asset-manifest.json` — titles and hero label; leave brand URLs as-is
- `src/generated/site-manifest.json` — `theme`, `locales`, `defaultLocale`
- `src/generated/ui-recipe.json` — `theme` / `archetype` matching the preset
- `src/config/locale/messages/en/common.json`
- `src/config/locale/messages/<lang>/common.json` — only when adding that language
- `src/components/site/brand.css`
- `src/config/style/active-theme.css`
- `src/components/site/active-fonts.ts`
- `public/logo.png`, `public/favicon.png`, `public/favicon.ico`, `public/og-image.png`
- extras from `scripts/gen-brand-assets.mjs`: `apple-touch-icon.png`, `icon-192.png`, `icon-512.png`
## Paths this pass must not touch
- `src/app/**` and `src/components/site/**` other than `brand.css` and `active-fonts.ts`
- adapters: `src/config/game.ts`, `src/config/homepage.ts`, `src/config/guides.ts`
- `template-contract.json`
- `content/guides/**`, `content/entities/**`
- category **slugs** in `src/generated/guide-categories.ts`
## How to know it worked
```bash
pnpm validate:site
pnpm build
```
Delete `.next` first if `public/logo.png` still looks like the template mark.
`validate:site` typically fails when:
- `domain` contains a scheme
- `eaLaunchDate` is not `YYYY-MM-DD`
- a homepage `href` has no matching route or content file
- CSS preset, font preset, `site-manifest.theme`, and `ui-recipe.theme` disagree
- brand CSS variables are missing or duplicated
- `public/logo.png`, `favicon.png`, or `og-image.png` is absent
- `cover-split` lacks `coverImage`, `gameplay-panel` lacks `gameplayImage`, or `video-center` lacks `trailerUrl`
- `// scaffold-default:en-only` is still in `site-locales.ts`
If `site-manifest.planSha256` is set, leftover `Example Game`, `REPLACE_WITH_OFFICIAL_SOURCE`, or `Replace this` in generated identity files also fail.
## Tell the user
Finished: identity, SEO, homepage copy, theme/accent, brand images, plus validate/build outcome.
Still theirs: real guides and entity JSON, Cloudflare domain, analytics IDs, `pnpm cf:deploy` or Vercel, and `docs/PITFALLS.md`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |