From twake-guidelines
Use when debugging, adding features to, or testing changes inside any cozy-* or twake-* library consumed by a Twake/Cozy React frontend app. Forbids hand-editing files under node_modules; directs to the linagora/cozy-libs monorepo and to yarn link or rlink for local testing.
How this skill is triggered — by the user, by Claude, or both
Slash command
/twake-guidelines:twake-frontend-lib-workflowThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Apply these rules whenever you need to change, debug, or experiment with the behavior of a `cozy-*` or `twake-*` library (e.g. `cozy-ui`, `cozy-client`, `cozy-stack-client`, `twake-mui`) from inside a Twake or Cozy React app.
Apply these rules whenever you need to change, debug, or experiment with the behavior of a cozy-* or twake-* library (e.g. cozy-ui, cozy-client, cozy-stack-client, twake-mui) from inside a Twake or Cozy React app.
node_modules by handEditing files under node_modules/ directly:
yarn install / npm install.If you find yourself wanting to change a file under node_modules/, stop. Use the workflow below.
Most shared cozy-* libraries live in the cozy-libs monorepo:
https://github.com/linagora/cozy-libs
Look there first. The monorepo uses Yarn workspaces; each package lives under packages/<name>.
If the package is not in cozy-libs, it has its own repository:
cozy-ui → https://github.com/cozy/cozy-uitwake-mui → https://github.com/linagora/twake-uitwake-* libraries → check the linagora GitHub org.Clone the relevant repo before going further.
Use yarn link, or rlink when the library repo ships that helper (it wraps linking plus a watch build).
# In the library checkout (e.g. cozy-libs/packages/cozy-ui)
yarn link
# In your consuming app
cd my-twake-app
yarn link cozy-ui
If the library needs transpilation (most do), start its watch build in parallel so your app picks up source changes on reload.
rlink automates the link and the watch build in one command when it exists in the library repo.
Once the fix works locally:
twake-git-conventions skill (atomic commits, Conventional Commits, structured PR).yarn unlink (or the rlink unlink equivalent) and a fresh yarn install so the app consumes the published version again.Forgetting step 4 will break the app for other developers and for CI, because the linked directory only exists on your machine.
node_modules/cozy-ui/transpiled/... or any other file under node_modules/.cozy-* / twake-* library into the app to "fix it locally".patch-package diff against a cozy-* / twake-* library. The fix belongs upstream.yarn.lock that references a linked directory.yarn unlink before pushing. If CI green-lights an app pointing at a link, the lock has drifted.npx claudepluginhub linagora/twake-guidelines --plugin twake-guidelinesProvides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.