style: Refactor bootstrap and agent profiles with enhanced UI guidelines#172
Conversation
📝 WalkthroughSummary by CodeRabbitDocumentation
WalkthroughFrontend design skill documentation receives targeted updates. AGENTS.md entry description and target usage are refined, while SKILL.md undergoes substantial restructuring to introduce design system alignment, prescriptive patterns, workflow steps, and code examples. Changes
Estimated code review effort🎯 2 (Simple) | ⏱️ ~10 minutes Suggested labels
🚥 Pre-merge checks | ✅ 2 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (2 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
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. Comment |
✅ Contributor ReportUser: @yacosta738
Contributor Report evaluates based on public GitHub activity. Analysis period: 2025-03-08 to 2026-03-08 |
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 2
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In @.agents/AGENTS.md:
- Line 178: Update the frontend-design registry row in AGENTS.md to include the
skill's version and compatibility/scope metadata from
.agents/skills/frontend-design/SKILL.md (e.g., add version: "2.0" and any
compatibility or scope labels), so the table entry for "frontend-design" exposes
the same version/compatibility details present in the SKILL.md file and
satisfies the agents metadata contract.
In @.agents/skills/frontend-design/SKILL.md:
- Around line 8-10: The metadata block contains a placeholder author value;
replace the author: generic-author entry inside the metadata block with the real
maintainer or owning team name (or a company/organization identifier) so the
registry has a valid contact/owner; update the author field in SKILL.md’s
metadata (alongside existing keys like version) to a meaningful value or
remove/mark it as “TBD” only if intentionally anonymous and documented.
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: ASSERTIVE
Plan: Pro
Run ID: 82e26639-ee3b-4af1-b763-ba8069376ef9
📒 Files selected for processing (2)
.agents/AGENTS.md.agents/skills/frontend-design/SKILL.md
📜 Review details
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)
- GitHub Check: pr-checks
- GitHub Check: sonar
- GitHub Check: pr-checks
- GitHub Check: Cloudflare Pages
🧰 Additional context used
📓 Path-based instructions (1)
.agents/AGENTS.md
📄 CodeRabbit inference engine (AGENTS.md)
.agents/AGENTS.md: Document agent configurations and capabilities in AGENTS.md
Maintain comprehensive agent metadata including name, description, purpose, and capabilities
Include version information and compatibility details for agents
Files:
.agents/AGENTS.md
🧠 Learnings (4)
📓 Common learnings
Learnt from: CR
Repo: dallay/corvus PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-02-17T07:28:38.934Z
Learning: Applies to .agents/AGENTS.md : Document agent configurations and capabilities in AGENTS.md
Learnt from: CR
Repo: dallay/corvus PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-02-17T07:28:38.934Z
Learning: Applies to .agents/AGENTS.md : Maintain comprehensive agent metadata including name, description, purpose, and capabilities
Learnt from: CR
Repo: dallay/corvus PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-02-17T07:28:38.934Z
Learning: Applies to .agents/AGENTS.md : Include version information and compatibility details for agents
📚 Learning: 2026-02-17T07:28:38.934Z
Learnt from: CR
Repo: dallay/corvus PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-02-17T07:28:38.934Z
Learning: Applies to .agents/AGENTS.md : Document agent configurations and capabilities in AGENTS.md
Applied to files:
.agents/AGENTS.md
📚 Learning: 2026-02-17T07:28:38.934Z
Learnt from: CR
Repo: dallay/corvus PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-02-17T07:28:38.934Z
Learning: Applies to .agents/AGENTS.md : Maintain comprehensive agent metadata including name, description, purpose, and capabilities
Applied to files:
.agents/AGENTS.md
📚 Learning: 2026-02-17T07:28:38.934Z
Learnt from: CR
Repo: dallay/corvus PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-02-17T07:28:38.934Z
Learning: Applies to .agents/AGENTS.md : Include version information and compatibility details for agents
Applied to files:
.agents/AGENTS.md
🪛 LanguageTool
.agents/skills/frontend-design/SKILL.md
[style] ~39-~39: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...ss they serve a real content purpose. - Avoid glassmorphism, floating shell layouts, ...
(ENGLISH_WORD_REPEAT_BEGINNING_RULE)
🔇 Additional comments (1)
.agents/skills/frontend-design/SKILL.md (1)
15-136: LGTM: the guidance is now specific, reuse-first, and hard to misuse.The added decision rules, anti-patterns, and search commands make the skill much more actionable for real product UI work.
| | [kotlin-multiplatform](.agents/skills/kotlin-multiplatform/SKILL.md) | KMP patterns, expect/actual | KMP modules | | ||
| | [tdd](.agents/skills/tdd/SKILL.md) | Test-Driven Development workflow | Red/Green/Refactor, new behavior | | ||
| | [frontend-design](.agents/skills/frontend-design/SKILL.md) | Create distinctive, production-grade frontend interfaces with high design quality | Building web components, pages, or applications | | ||
| | [frontend-design](.agents/skills/frontend-design/SKILL.md) | Create production-grade frontend UI with strong visual direction while avoiding generic AI patterns | Building or refining web components, pages, dashboards, or application UI | |
There was a problem hiding this comment.
🛠️ Refactor suggestion | 🟠 Major
Add version/compatibility details to this registry entry.
The updated row aligns the description, but the registry still does not expose the skill version or compatibility/scope details now present in SKILL.md (for example, the new version: "2.0" metadata). That keeps AGENTS.md short of the metadata contract for agent entries.
As per coding guidelines, "Include version information and compatibility details for agents."
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In @.agents/AGENTS.md at line 178, Update the frontend-design registry row in
AGENTS.md to include the skill's version and compatibility/scope metadata from
.agents/skills/frontend-design/SKILL.md (e.g., add version: "2.0" and any
compatibility or scope labels), so the table entry for "frontend-design" exposes
the same version/compatibility details present in the SKILL.md file and
satisfies the agents metadata contract.
| metadata: | ||
| author: generic-author | ||
| version: "2.0" |
There was a problem hiding this comment.
Replace the placeholder author metadata.
author: generic-author reads like a stub value. If this metadata is meant to be consumed, it should point to the real maintainer/owner; otherwise it will age poorly and reduce trust in the registry data.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In @.agents/skills/frontend-design/SKILL.md around lines 8 - 10, The metadata
block contains a placeholder author value; replace the author: generic-author
entry inside the metadata block with the real maintainer or owning team name (or
a company/organization identifier) so the registry has a valid contact/owner;
update the author field in SKILL.md’s metadata (alongside existing keys like
version) to a meaningful value or remove/mark it as “TBD” only if intentionally
anonymous and documented.
|
1 participant
This pull request updates the definition and documentation for the
frontend-designskill to clarify its intended use, modernize its guidance, and discourage generic AI-generated UI patterns. The changes expand the skill's description, add best practices and anti-patterns, and provide practical examples and decision rules for frontend design work.Skill documentation improvements:
descriptionin.agents/skills/frontend-design/SKILL.mdto emphasize creating production-grade frontend UI with strong visual direction, while avoiding generic AI-generated patterns. Added license and metadata fields.Skill registry update:
frontend-designskill entry in.agents/AGENTS.mdto match the new description and clarify its scope (including dashboards and UI refinement).