todome-frontend-implementation
Skill1 starsChanged 7 months agoMITView on GitHub
Apply todome-specific frontend constraints when implementing or reviewing changes under `client/`. Use when editing React/Vite TypeScript UI files, client-side WebSocket state handling, shared client/server types in `client/src/types.ts`, or CSS in `client/src/style.css`.
In this repository15 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .agents/skills/vercel-composition-patterns/AGENTS.mdAGENTS.md
- .agents/skills/vercel-react-best-practices/AGENTS.mdAGENTS.md
- .agents/skills/vercel-react-view-transitions/AGENTS.mdAGENTS.md
- client/AGENTS.mdAGENTS.md
- server/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- todome-e2e-runnerSkill
- todome-server-implementationSkill
- todome-server-navigatorSkill
- todome-type-lint-runnerSkill
- vercel-composition-patternsSkill
- vercel-react-best-practicesSkill
- vercel-react-view-transitionsSkill
- web-design-guidelinesSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
16 rules. About 0 are common, 5 are distinctive, and 11 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
11
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 12
Keep state in the existing App.tsx-centered flow.
- Very specific: line 13
Treat server *_sync messages as the source of truth.
- Very specific: line 14
When a payload or WebSocket shape changes, update both client/src/types.ts and the matching server/ payload usage together.
- Very specific: line 15
Do not use any. Prefer existing types, unions, and Record shapes.
- Very specific: line 16
Put styling in client/src/style.css.
- Very specific: line 17
Add new components under client/src/components/ as PascalCase.tsx files with named exports.
- Distinctive: line 21
Read the relevant component, hook, type definitions, and matching server handler before editing.
- Distinctive: line 22
If the change touches messages or payloads, trace the matching server path and update both sides together.
- Very specific: line 24
If styles change, extend client/src/style.css rather than scattering styles across files.
- Distinctive: line 32
If the UI changed, start the app and verify the main interaction path in the browser before considering the task done.
- Very specific: line 36
Use todome-type-lint-runner when you mainly need a compact report from frontend tsc and lint.
- Very specific: line 37
Use vercel-react-best-practices when the change involves React performance or rendering behavior.
- Very specific: line 38
Use vercel-composition-patterns when the component API is drifting toward boolean-prop sprawl.
- Very specific: line 39
Use vercel-react-view-transitions only when the task explicitly involves view transitions or state-change animation.
- Distinctive: line 43
Keep recommendations and edits concrete and repo-specific.
- Distinctive: line 44
Prefer small diffs that preserve the existing visual language and data flow.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Todome Frontend Implementation
Apply the repo-specific frontend rules for todome. This skill mirrors the intent of client/AGENTS.md and .claude/rules/frontend.md, but packages it as an explicit Codex skill.
Core Rules
- Keep state in the existing
App.tsx-centered flow. Do not introduce Redux, Zustand, or new global context stores. - Treat server
*_syncmessages as the source of truth. Avoid adding optimistic state paths unless the repo already uses them for that case. - When a payload or WebSocket shape changes, update both
client/src/types.tsand the matchingserver/payload usage together. - Do not use
any. Prefer existing types, unions, andRecordshapes. - Put styling in
client/src/style.css. Do not introduce CSS-in-JS, Tailwind, MUI, orstyled-components. - Add new components under
client/src/components/asPascalCase.tsxfiles with named exports.
Workflow
- Read the relevant component, hook, type definitions, and matching server handler before editing.
- If the change touches messages or payloads, trace the matching server path and update both sides together.
- Reuse existing UI and state patterns instead of adding new abstractions.
- If styles change, extend
client/src/style.cssrather than scattering styles across files. - After changes, run:
cd client && npx tsc -b
cd client && npm run lint- If the UI changed, start the app and verify the main interaction path in the browser before considering the task done.
Companion Skills
- Use
todome-type-lint-runnerwhen you mainly need a compact report from frontendtscand lint. - Use
vercel-react-best-practiceswhen the change involves React performance or rendering behavior. - Use
vercel-composition-patternswhen the component API is drifting toward boolean-prop sprawl. - Use
vercel-react-view-transitionsonly when the task explicitly involves view transitions or state-change animation.
Output Expectations
- Keep recommendations and edits concrete and repo-specific.
- Prefer small diffs that preserve the existing visual language and data flow.
- Mention any server-side companion updates if the frontend change cannot stand alone.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

