{"enrichment":{"faq":[{"a":"diagnostics-development teaches you to build error messages for Biome lint rules using the Diagnostic trait and RuleDiagnostic builder. Start by deriving the Diagnostic trait on your error type, then use RuleDiagnostic to construct messages with advice, code frames, and markup. The skill covers registering diagnostic categories, configuring severity levels, and applying show-don't-tell philosophy so users understand what went wrong, why it matters, and how to fix it.","q":"How to create diagnostics in Biome?"},{"a":"diagnostics-development explains that Biome advice types let you attach actionable guidance to diagnostics. Code frame diffs show before-and-after code snippets, helping users visualize fixes. The skill teaches markup formatting for emphasis and clarity, multi-advice diagnostics for complex issues, and how to tag diagnostics as fixable. Together, these create high-quality diagnostic output that guides developers toward resolution.","q":"What are Biome advice types and how do I use code frame diffs?"},{"a":"diagnostics-development emphasizes building user-friendly messages by explaining the problem clearly, showing why it matters, and providing concrete next steps. Use markup formatting for readability, include code frames to contextualize errors, and apply the show-don't-tell principle\u2014let the code and diffs speak rather than abstract language. The skill covers best practices for actionable error messages that help developers fix issues quickly.","q":"How do I write lint rule error messages that are user-friendly?"},{"a":"diagnostics-development teaches the RuleDiagnostic builder pattern as the primary way to construct diagnostics for lint rules. This pattern lets you chain methods to set messages, advice, code frames, severity, and tags. The builder approach keeps diagnostic creation readable and maintainable, and the skill shows how to register diagnostic categories and configure severity levels to match your rule's intent.","q":"What is the RuleDiagnostic builder pattern in Biome?"},{"a":"diagnostics-development covers registering diagnostic categories to organize your lint rules and configuring severity levels\u2014error, warning, or hint\u2014to control how Biome reports issues. Proper categorization and severity configuration ensure your diagnostics integrate smoothly with Biome's configuration system and user expectations, making linting output consistent and predictable.","q":"How do I register diagnostic categories and set severity levels?"},{"a":"diagnostics-development teaches markup formatting options for emphasis, code highlighting, and clarity in diagnostic messages. The skill covers the Diagnostic derive macro, which streamlines trait implementation, and shows how to combine markup with code frames and advice for polished, professional diagnostic output that users can quickly parse and act upon.","q":"What markup formatting and derive macros does Biome diagnostics support?"}],"shadow_tags":["error-messaging","lint-rule-development","user-facing-text","code-quality-feedback","diagnostic-framework","developer-experience","actionable-guidance","static-analysis-output"],"summary_rewrite":"Build effective error messages, warnings, and hints for Biome lint rules using the Diagnostic trait and advice system. Learn to craft messages that explain what went wrong, why it matters, and how to fix it\u2014with rich markup, code frames, and actionable guidance."},"files":[{"bytes":9542,"path":".claude/skills/diagnostics-development/SKILL.md","sha256":"5c275c36d94285ec067399a05b75f5e4a7bf4d8eb2a2ff485b12e34a666e21cc","url":"https://skillfed.io/files/biomejs/biome/diagnostics-development/c3b2c0af/SKILL.md"}],"id":"biomejs/biome/diagnostics-development","links":{"html":"https://skillfed.io/biomejs/biome/diagnostics-development","md":"https://skillfed.io/biomejs/biome/diagnostics-development.md","repo":"https://github.com/biomejs/biome"},"meta":{"agents_supported":["claude-code"],"first_seen":"2026-07-28","forks":1157,"language":"Rust","last_updated":"2026-07-27","license":"Apache-2.0","name":"diagnostics-development","publisher":"biomejs","stars":25418},"relations":{"similar":[{"id":"biomejs/biome/lint-rule-development"},{"id":"notque/vexjoy-agent/code-linting"},{"id":"biomejs/biome/changeset"},{"id":"biomejs/biome/testing-codegen"},{"id":"bobmatnyc/claude-mpm-skills/biome"},{"id":"biomejs/biome/biome-developer"},{"id":"secondsky/claude-skills/ultracite"},{"id":"biomejs/biome/pull-request"},{"id":"shipshitdev/skills/typescript-expert"},{"id":"duck4nh/antigravity-kit/typescript-expert"}]},"slug":{"owner":"biomejs","repo":"biome","skill":"diagnostics-development"},"version":"c3b2c0af"}