Skip to content

Add custom copilot instructions and skills#96

Merged
albx merged 9 commits into
mainfrom
feature/86-add-custom-copilot-instructions-and-skills
Jun 10, 2026
Merged

Add custom copilot instructions and skills#96
albx merged 9 commits into
mainfrom
feature/86-add-custom-copilot-instructions-and-skills

Conversation

@albx

@albx albx commented Jun 8, 2026

Copy link
Copy Markdown
Owner

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

  • Added .agents/skills/blazor/SKILL.md containing detailed guidelines for BitBlazor component authoring, including workflow, base class hierarchy, CSS class composition, accessibility requirements, and validation steps.
  • Introduced .agents/skills/blazor/manifest.json specifying the skill version, category, and package prefix for BitBlazor.

Reference Documentation

  • Added references/patterns.md describing recommended code patterns for general-purpose and form components, CSS class composition, performance best practices, and JS interop usage.
  • Added references/anti-patterns.md listing common mistakes and their solutions for BitBlazor component development.
  • Added references/testing.md (not shown in the diff, but referenced) for bUnit testing conventions.
  • Added references/stories.md detailing how to create and structure BlazingStory files for component previews, including file location, structure, and conventions for Storybook integration.
  • Added references/docs-template.md providing a standardized template and conventions for component documentation pages, including required sections, parameter tables, enum documentation, and usage examples.

Accessibility and Quality

  • Embedded accessibility requirements and validation steps directly in the skill documentation, referencing the authoritative a11y.instructions.md and enumerating common accessibility checks (BL1–BL6) for new components.

These changes together establish a strong foundation for consistent, accessible, and maintainable BitBlazor component development.

@albx albx linked an issue Jun 8, 2026 that may be closed by this pull request
@albx albx requested a review from Copilot June 8, 2026 05:55

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread .github/instructions/blazor.instructions.md
Comment thread .github/instructions/blazor.instructions.md Outdated
Comment thread .github/instructions/blazor.instructions.md
Comment thread docs/agents-and-skills.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@albx albx marked this pull request as ready for review June 10, 2026 05:22
@albx albx merged commit 10d03ff into main Jun 10, 2026
2 checks passed
@albx albx deleted the feature/86-add-custom-copilot-instructions-and-skills branch June 10, 2026 05:22
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.

Add custom copilot instructions and skills

2 participants