agentleFS
tanitaka-techtanitaka-tech/todome/.agents/skills/todome-frontend-implementation/SKILL.md

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

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
  1. Very specific:

    Keep state in the existing App.tsx-centered flow.

    line 12
  2. Very specific:

    Treat server *_sync messages as the source of truth.

    line 13
  3. Very specific:

    When a payload or WebSocket shape changes, update both client/src/types.ts and the matching server/ payload usage together.

    line 14
  4. Very specific:

    Do not use any. Prefer existing types, unions, and Record shapes.

    line 15
  5. Very specific:

    Put styling in client/src/style.css.

    line 16
  6. Very specific:

    Add new components under client/src/components/ as PascalCase.tsx files with named exports.

    line 17
  7. Distinctive:

    Read the relevant component, hook, type definitions, and matching server handler before editing.

    line 21
  8. Distinctive:

    If the change touches messages or payloads, trace the matching server path and update both sides together.

    line 22
  9. Very specific:

    If styles change, extend client/src/style.css rather than scattering styles across files.

    line 24
  10. Distinctive:

    If the UI changed, start the app and verify the main interaction path in the browser before considering the task done.

    line 32
  11. Very specific:

    Use todome-type-lint-runner when you mainly need a compact report from frontend tsc and lint.

    line 36
  12. Very specific:

    Use vercel-react-best-practices when the change involves React performance or rendering behavior.

    line 37
  13. Very specific:

    Use vercel-composition-patterns when the component API is drifting toward boolean-prop sprawl.

    line 38
  14. Very specific:

    Use vercel-react-view-transitions only when the task explicitly involves view transitions or state-change animation.

    line 39
  15. Distinctive:

    Keep recommendations and edits concrete and repo-specific.

    line 43
  16. Distinctive:

    Prefer small diffs that preserve the existing visual language and data flow.

    line 44

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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 *_sync messages 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.ts and the matching server/ payload usage together.
  • Do not use any. Prefer existing types, unions, and Record shapes.
  • Put styling in client/src/style.css. Do not introduce CSS-in-JS, Tailwind, MUI, or styled-components.
  • Add new components under client/src/components/ as PascalCase.tsx files with named exports.

Workflow

  1. Read the relevant component, hook, type definitions, and matching server handler before editing.
  2. If the change touches messages or payloads, trace the matching server path and update both sides together.
  3. Reuse existing UI and state patterns instead of adding new abstractions.
  4. If styles change, extend client/src/style.css rather than scattering styles across files.
  5. After changes, run:
cd client && npx tsc -b
cd client && npm run lint
  1. 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-runner when you mainly need a compact report from frontend tsc and lint.
  • Use vercel-react-best-practices when the change involves React performance or rendering behavior.
  • Use vercel-composition-patterns when the component API is drifting toward boolean-prop sprawl.
  • Use vercel-react-view-transitions only 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.