Skip to content

refactor(skills): consolidate frontend skills into frontend-workflow + per-tree CLAUDE.md symlinks - #1811

Merged
AnishSarkar22 merged 6 commits into
MODSetter:devfrom
AnishSarkar22:feat/skills
Sep 18, 2026
Merged

AnishSarkar22 merged 6 commits into
MODSetter:devfrom
AnishSarkar22:feat/skills

Conversation

@AnishSarkar22

@AnishSarkar22 AnishSarkar22 commented Sep 18, 2026

Copy link
Copy Markdown
Collaborator

What

Why

Fixes #

How to test

High-level PR Summary

This PR consolidates frontend development guidance into a unified frontend-workflow skill that bundles React performance patterns, color systems, UI polish rules, and motion design principles, while adding a separate migrate-radix-to-base skill for component library migration. The frontend-workflow skill serves as the single entry point for all UI work across surfsense_web and surfsense_local/frontend, orchestrating React/Next.js best practices, shadcn/ui integration, color tokens, typography, animations, and Apple-style motion design. A comprehensive Radix UI to Base UI migration skill provides detailed prop mappings, part renames, and workflow guidance for converting component libraries. Project-level AGENTS.md and CLAUDE.md files are updated to route frontend work through the new workflow, with shadcn now explicitly positioned as a specialized tool loaded after the main workflow rather than a replacement for it.

⏱️ Estimated Review Time: 1-3 hours

💡 Review Order Suggestion
Order File Path
1 .agents/skills/frontend-workflow/SKILL.md
2 .agents/skills/frontend-workflow/color/SKILL.md
3 .agents/skills/frontend-workflow/color/PALETTE.css
4 .agents/skills/frontend-workflow/polish/SKILL.md
5 .agents/skills/frontend-workflow/polish/typography.md
6 .agents/skills/frontend-workflow/polish/surfaces.md
7 .agents/skills/frontend-workflow/polish/animations.md
8 .agents/skills/frontend-workflow/polish/icons.md
9 .agents/skills/frontend-workflow/polish/performance.md
10 .agents/skills/frontend-workflow/motion/apple-design.md
11 .agents/skills/frontend-workflow/react-performance/SKILL.md
12 .agents/skills/migrate-radix-to-base/SKILL.md
13 .agents/skills/migrate-radix-to-base/universal-patterns.md
14 .agents/skills/migrate-radix-to-base/overlays.md
15 .agents/skills/migrate-radix-to-base/menus.md
16 .agents/skills/migrate-radix-to-base/form-controls.md
17 .agents/skills/migrate-radix-to-base/disclosure.md
18 .agents/skills/migrate-radix-to-base/display-misc.md
19 .agents/skills/migrate-radix-to-base/consumer-props.md
20 .agents/skills/migrate-radix-to-base/class-mapping.md
21 .agents/skills/migrate-radix-to-base/wrapper-shapes.md
22 .agents/skills/shadcn/SKILL.md
23 AGENTS.md
24 surfsense_backend/CLAUDE.md
25 surfsense_local/AGENTS.md
26 surfsense_local/CLAUDE.md
27 surfsense_mcp/CLAUDE.md
28 surfsense_web/AGENTS.md
29 surfsense_web/CLAUDE.md
30 .gitignore

Need help? Join our Discord

AnishSarkar22 and others added 6 commits September 18, 2026 15:47
Adds animation-vocabulary, apple-design, color-system, frontend-workflow,
make-interfaces-feel-better, and migrate-radix-to-base skill packages for
use during the base-ui migration and general frontend/design work.
Bundle color-system, make-interfaces-feel-better, apple-design and
vercel-react-best-practices under frontend-workflow as color/, polish/,
motion/ and react-performance/. Their icon, colour and motion rules
overlapped with no shared parent to say which wins; the router now does.

Keep shadcn top-level — its allowed-tools grant and live `info --json`
substitution only work in a discovered SKILL.md.

Drop disable-model-invocation from frontend-workflow, which had kept the
router and its precedence rules out of context entirely.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude Code reads CLAUDE.md, not AGENTS.md, and only the repo root had the
symlink — so the per-tree AGENTS.md files never loaded, making "nearest
AGENTS.md wins" false in practice.

Nested memory files load lazily when a file in that directory is read, so
each tree's rules now reach an agent working in it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 18, 2026

Copy link
Copy Markdown

@AnishSarkar22 is attempting to deploy a commit to the Rohan Verma's projects Team on Vercel.

A member of the Team first needs to authorize it.

@coderabbitai

coderabbitai Bot commented Sep 18, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 99fc3d25-f1c4-4306-a695-0f657c180e91

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@AnishSarkar22 AnishSarkar22 changed the title Feat/skills refactor(skills): consolidate frontend skills into a single frontend-workflow entry point Sep 18, 2026
@AnishSarkar22 AnishSarkar22 changed the title refactor(skills): consolidate frontend skills into a single frontend-workflow entry point refactor(skills): consolidate frontend skills into frontend-workflow + per-tree CLAUDE.md symlinks Sep 18, 2026
@AnishSarkar22
AnishSarkar22 merged commit 6ad505d into MODSetter:dev Sep 18, 2026
6 of 10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant