Add custom copilot instructions and skills#96
Merged
albx merged 9 commits intoJun 10, 2026
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds repository-scoped agent definitions, Copilot instruction files, and reusable skills/reference docs to standardize BitBlazor component authoring (including accessibility and testing) and documents where contributors can find and extend these assets.
Changes:
- Added new repo instruction files for Blazor component authoring conventions and a comprehensive WCAG 2.2 AA accessibility ruleset.
- Added agent definitions (
developer,code-reviewer,software-architect,projectmanager) plus skills (blazor,issue-reader,issue-writer) and supporting reference docs/templates. - Updated docs index to link to a new “Agents, Instructions & Skills” reference page.
Reviewed changes
Copilot reviewed 19 out of 19 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/README.md | Adds a docs index entry linking to the new agents/skills reference page. |
| docs/agents-and-skills.md | New contributor-facing index of repo agents, instruction files, and skills. |
| .github/instructions/blazor.instructions.md | New Blazor component authoring conventions intended to apply to Razor/component files. |
| .github/instructions/a11y.instructions.md | New comprehensive accessibility standards and anti-pattern catalog (WCAG 2.2 AA). |
| .github/agents/software-architect.agent.md | Defines the software-architect agent scope/workflow and skill dependency. |
| .github/agents/projectmanager.agent.md | Defines the projectmanager agent workflow for creating issues (with skill dependencies). |
| .github/agents/developer.agent.md | Defines the developer agent workflow for implementing BitBlazor work (with skill dependencies). |
| .github/agents/code-reviewer.agent.md | Defines the code-reviewer agent workflow for standards + accessibility review. |
| .agents/skills/issue-writer/SKILL.md | Adds a CLI-driven workflow for creating GitHub issues in this repo. |
| .agents/skills/issue-writer/manifest.json | Skill manifest metadata for issue-writer. |
| .agents/skills/issue-reader/SKILL.md | Adds a CLI-driven workflow for retrieving/searching GitHub issues in this repo. |
| .agents/skills/issue-reader/manifest.json | Skill manifest metadata for issue-reader. |
| .agents/skills/blazor/SKILL.md | Adds the BitBlazor component authoring/review skill with links to references. |
| .agents/skills/blazor/manifest.json | Skill manifest metadata for blazor. |
| .agents/skills/blazor/references/testing.md | Adds bUnit testing conventions and examples. |
| .agents/skills/blazor/references/stories.md | Adds BlazingStory story file conventions and template. |
| .agents/skills/blazor/references/patterns.md | Adds component patterns for base classes, CSS class building, performance, JS interop. |
| .agents/skills/blazor/references/docs-template.md | Adds a standard documentation page template and required sections. |
| .agents/skills/blazor/references/anti-patterns.md | Adds a concise list of common BitBlazor anti-patterns and fixes. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request introduces comprehensive documentation and reference materials for authoring, extending, and testing BitBlazor library components. It establishes clear guidelines, anti-patterns, code patterns, documentation templates, and storybook conventions to ensure consistency, accessibility, and best practices across the BitBlazor component library.
The most important changes are:
Skill Definition and Metadata
.agents/skills/blazor/SKILL.mdcontaining detailed guidelines for BitBlazor component authoring, including workflow, base class hierarchy, CSS class composition, accessibility requirements, and validation steps..agents/skills/blazor/manifest.jsonspecifying the skill version, category, and package prefix for BitBlazor.Reference Documentation
references/patterns.mddescribing recommended code patterns for general-purpose and form components, CSS class composition, performance best practices, and JS interop usage.references/anti-patterns.mdlisting common mistakes and their solutions for BitBlazor component development.references/testing.md(not shown in the diff, but referenced) for bUnit testing conventions.references/stories.mddetailing how to create and structure BlazingStory files for component previews, including file location, structure, and conventions for Storybook integration.references/docs-template.mdproviding a standardized template and conventions for component documentation pages, including required sections, parameter tables, enum documentation, and usage examples.Accessibility and Quality
a11y.instructions.mdand enumerating common accessibility checks (BL1–BL6) for new components.These changes together establish a strong foundation for consistent, accessible, and maintainable BitBlazor component development.