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 |
SKILL.md
View on GitHub---
name: tomtwiki-quick-start
description: >-
Turns 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.
---
# TomeWiki Quick Start
Keep this folder identical in three places: `.claude/skills/tomtwiki-quick-start/` (Claude Code), `.cursor/skills/tomtwiki-quick-start/` (Cursor), and `.agents/skills/tomtwiki-quick-start/` (Codex).
A new clone of [TomeWiki](https://github.com/tiankonglan/tomtwiki) still reads "Example Game". This skill swaps that identity using knobs the template already ships. It does not add routes, features, or a new content model.
Open a single file under `references/` when you need it. Do not dump the whole folder into context.
## Permitted edits
`references/07-checklist.md` is the full path list. Nothing else is in scope.
Leave these alone:
- App Router and most UI (`src/app/**`, `src/components/site/**` except the two brand/font entry files)
- `template-contract.json`
- Auth, databases, billing, admin screens
- Invented Steam IDs, patch numbers, loot tables, or publisher endorsement
- `src/app/favicon.ico` (clashes with `public/favicon.ico` and 500s the icon)
- Guide category folder names (must keep matching `content/guides/<slug>/`)
- Stock `public/logo.png`, `favicon.png`, or `og-image.png`
## Finish line
`pnpm install` once if `node_modules` is missing.
After the file edits:
- `pnpm validate:site`
- `pnpm build`
If the new logo does not appear, Next is serving a cached asset; delete `.next` and rebuild. `pnpm quality:gate` is optional and matches CI (format, lint, types, validate, build).
Repair failures only on permitted paths unless the user widens the job.
## Brief
`references/00-brief.md` — game title and domain are enough to start. Ask at most once for holes, then leave searchable `TODO:` comments. Ignore Steam ID, analytics, and extra languages unless the user gave them.
## Order of work
| Step | File |
|------|------|
| Worker + env | `references/01-env-and-worker.md` |
| Game / site identity | `references/02-identity.md` |
| Title, description, keywords | `references/03-seo.md` |
| Homepage strings (same blocks) | `references/04-homepage.md` |
| Accent color and visual preset | `references/05-theme.md` |
| Logo, favicon, social preview | `references/06-brand-assets.md` |
| Permitted paths and sign-off | `references/07-checklist.md` |
## Brand images
Call the generator that already lives in this repo. Do not add a new image script.
```bash
node scripts/gen-brand-assets.mjs \
--game "<gameFullName>" \
--short "<gameShortName>" \
--domain "<domain>" \
--color "<#RRGGBB>" \
--tagline "<short tagline>"
```
Pass `--emblem path/to/emblem.png` when the user has a square mark. `sharp` is already a dependency.
## Hand off
Real guides belong in `content/guides/`; entity records in `content/entities/`. Extra locales follow `docs/QUICKSTART.md` section 7 (drop `// scaffold-default:en-only`). Domain bind, analytics, and `pnpm cf:deploy` / Vercel import stay with the user.
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 |