chore: add vercel skills#997
Conversation
Signed-off-by: Carlos Feria <2582866+carlosthe19916@users.noreply.github.com>
There was a problem hiding this comment.
Sorry @carlosthe19916, your pull request is larger than the review limit of 150000 diff characters
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #997 +/- ##
=======================================
Coverage 66.91% 66.91%
=======================================
Files 221 221
Lines 3887 3887
Branches 903 903
=======================================
Hits 2601 2601
Misses 945 945
Partials 341 341 ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
| title: Avoid Boolean Prop Proliferation | ||
| impact: CRITICAL | ||
| impactDescription: prevents unmaintainable component variants | ||
| tags: composition, props, architecture | ||
| --- | ||
|
|
||
| ## Avoid Boolean Prop Proliferation | ||
|
|
||
| Don't add boolean props like `isThread`, `isEditing`, `isDMThread` to customize | ||
| component behavior. Each boolean doubles possible states and creates | ||
| unmaintainable conditional logic. Use composition instead. | ||
|
|
||
| **Incorrect (boolean props create exponential complexity):** |
There was a problem hiding this comment.
I believe adding set of skills from third parties could lead to the situation where new generated code by ai would not hold the same structure and patterns as already implemented human-generated code in this repo.
F.e this skills that have CRITICAL impact is avoiding boolean props like isEditing, isThread etc and uses composition instead.
I like composition pattern but as i see from a source code we didn't have a single component that uses composition and we have a bunch of components here that have boolean props.
Probably there are more examples like this.
And maybe there is not a bad thing that new code would be better than existing one, would use the best practices etc.
To be honest, i don't have a strong opinion on that just leaving my thoughts here.
There was a problem hiding this comment.
I believe adding set of skills from third parties could lead to the situation where new generated code by ai would not hold the same structure and patterns as already implemented human-generated code in this repo.
Yes, this is a good point. After skills like these ones are merged it is important to scan our repository and align it to the new skills so we don't see the scenario that you described.
Locally playing I already scanned the repository against the content of this PR and the result was: #999 -> this issue describe the road to align our code to the skills and good practices.
And maybe there is not a bad thing that new code would be better than existing one, would use the best practices etc.
The old and the new code should match title by title, as mentioned above, an example of making the old code as good/bad as the new one is #999
There was a problem hiding this comment.
Just wanted to add a note that just because we add these vercel skills to this repo doesn't mean we would need to keep them. We can decide to swap them out for other skills that better suit us later on.
|
@carlosthe19916 Can you hold of with the merge of this PR until we have that chance to discuss it. |
|
Hi @PhilipCattanach, thanks for bringing this to our attention. We are working on standardizing quality across the UI work we're responsible for, and this was a step towards that.
Although the specific skills in this PR are a bit more broad, this touches an important point. By definition, skills are reusable instructions for agents that specialize their abilities. I think the best people to write these specialized instructions, which we will depend on for critical workflows, are the ones who have been doing these workflows manually for some time. Frontend developers have different problems to solve than backend developers, just as even two separate frontend teams may operate differently based on their customer needs. My point is, how do you know Marco's skills will cover our use cases if only we know what our use cases are?
Totally agree. We've been asked to look into agentic SDLC workflows and, simultaneously, to keep an eye on quality drop. If we're expected to adopt this plugin but not our own stuff, then it's important that we're involved in any workflow standardization that could impact our team. If we don't do that, and we try to use a single tool to cover all use cases, the quality of our products will drop. |
Vercel skills from https://vercel.com/docs/agent-resources/skills
What do you think guys? installing Skills from https://skills.sh/ comes with a .lock file which also help us to upgrade