feat: Add hve-artifact-authoring skill to coding-standards collection#1678
Open
dmavroeid wants to merge 4 commits into
Open
feat: Add hve-artifact-authoring skill to coding-standards collection#1678dmavroeid wants to merge 4 commits into
dmavroeid wants to merge 4 commits into
Conversation
Adds the hve-artifact-authoring skill with 96% pass rate (vs 43% baseline) in blind A/B evaluation across 8 evals and 34 expectations. Closes microsoft#1506
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #1678 +/- ##
==========================================
- Coverage 85.50% 85.49% -0.01%
==========================================
Files 82 82
Lines 11805 11805
==========================================
- Hits 10094 10093 -1
- Misses 1711 1712 +1
Flags with carried forward coverage won't be shown. Click here to find out more. 🚀 New features to boost your workflow:
|
Author
|
CI Notes on remaining failures:
|
Contributor
There was a problem hiding this comment.
Pull request overview
Adds the new hve-artifact-authoring skill to the coding-standards collection (and the aggregate hve-core-all collection), with accompanying generated plugin/collection documentation updates.
Changes:
- Introduces the new skill package at
.github/skills/coding-standards/hve-artifact-authoring/(SKILL.md + reference + templates). - Registers the skill in
collections/coding-standards.collection.ymlandcollections/hve-core-all.collection.yml. - Updates auto-generated collection/plugin READMEs to list the new skill.
Reviewed changes
Copilot reviewed 15 out of 15 changed files in this pull request and generated 13 comments.
Show a summary per file
| File | Description |
|---|---|
| plugins/hve-core-all/README.md | Updates plugin skill listing to include hve-artifact-authoring |
| plugins/coding-standards/README.md | Updates plugin skill listing for coding-standards |
| collections/hve-core-all.collection.yml | Adds the new skill to the aggregate collection manifest |
| collections/hve-core-all.collection.md | Updates the aggregate collection’s auto-generated skill table |
| collections/coding-standards.collection.yml | Adds the new skill to the coding-standards collection manifest |
| collections/coding-standards.collection.md | Updates the coding-standards auto-generated skill table |
| .github/skills/coding-standards/hve-artifact-authoring/SKILL.md | Adds the new skill’s primary documentation and guidance |
| .github/skills/coding-standards/hve-artifact-authoring/references/frontmatter-schemas.md | Adds a frontmatter field reference doc |
| .github/skills/coding-standards/hve-artifact-authoring/assets/agent-template.md | Adds a starter agent template |
| .github/skills/coding-standards/hve-artifact-authoring/assets/collection-template.yml | Adds a starter collection manifest template |
| .github/skills/coding-standards/hve-artifact-authoring/assets/instruction-template.md | Adds a starter instructions template |
| .github/skills/coding-standards/hve-artifact-authoring/assets/prompt-template.md | Adds a starter prompt template |
| .github/skills/coding-standards/hve-artifact-authoring/assets/skill-template.md | Adds a starter skill template |
Comment on lines
+101
to
+105
| | Skill | Description | | ||
| |------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ||
| | hve-artifact-authoring | Create, validate, and package AI artifacts for HVE Core, GitHub Copilot's prompt engineering framework. Covers agents, prompts, instructions, skills, and collections with frontmatter contracts, naming conventions, collection packaging, subagent delegation, workspace state tracking, and CI validation pipelines. Use when building any markdown-based AI artifact that follows the four-tier delegation model (Prompts → Agents → Instructions → Skills) with schema-validated frontmatter and collection-based distribution. | ||
| | | ||
| | python-foundational | Foundational Python best practices, idioms, and code quality fundamentals - Brought to you by microsoft/hve-core | |
Comment on lines
+540
to
+544
| | Skill | Description | | ||
| |---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ||
| | hve-artifact-authoring | Create, validate, and package AI artifacts for HVE Core, GitHub Copilot's prompt engineering framework. Covers agents, prompts, instructions, skills, and collections with frontmatter contracts, naming conventions, collection packaging, subagent delegation, workspace state tracking, and CI validation pipelines. Use when building any markdown-based AI artifact that follows the four-tier delegation model (Prompts → Agents → Instructions → Skills) with schema-validated frontmatter and collection-based distribution. | ||
| | | ||
| | python-foundational | Foundational Python best practices, idioms, and code quality fundamentals - Brought to you by microsoft/hve-core | |
Comment on lines
+1
to
+11
| --- | ||
| name: hve-artifact-authoring | ||
| description: > | ||
| Create, validate, and package AI artifacts for HVE Core, GitHub Copilot's prompt engineering | ||
| framework. Covers agents, prompts, instructions, skills, and collections with frontmatter | ||
| contracts, naming conventions, collection packaging, subagent delegation, workspace state | ||
| tracking, and CI validation pipelines. Use when building any markdown-based AI artifact that | ||
| follows the four-tier delegation model (Prompts → Agents → Instructions → Skills) with | ||
| schema-validated frontmatter and collection-based distribution. | ||
| version: 1.0.0 | ||
| --- |
Comment on lines
+160
to
+166
| ``` | ||
| <!-- <example-topic> --> | ||
| ```code | ||
| [example] | ||
| ``` | ||
| <!-- </example-topic> --> | ||
| ``` |
| 1. **Create directory:** `.github/skills/{collection-id}/{skill-name}/` | ||
|
|
||
| 2. **Required structure:** | ||
| ``` |
Comment on lines
+6
to
+7
|
|
||
| ## Inputs |
Comment on lines
+5
to
+6
|
|
||
| ## Scope |
| * Guideline two | ||
|
|
||
| <!-- <example-topic1> --> | ||
| ``` |
| @@ -0,0 +1,47 @@ | |||
| --- | |||
| name: new-agent-name | |||
| kind: prompt | ||
| - path: .github/instructions/collection-id/instruction-name.instructions.md | ||
| kind: instruction | ||
| - path: .github/skills/collection-id/skill-name/SKILL.md |
bindsi
approved these changes
Jun 5, 2026
bindsi
left a comment
bindsi
left a comment
Member
There was a problem hiding this comment.
Automated review (bindsi batch). The hve-artifact-authoring skill is a valuable meta-skill for creating HVE Core artifacts. The SKILL.md comprehensively covers all artifact types (agents, prompts, instructions, skills, collections) with proper frontmatter schemas, templates, and validation guidance. Collection wiring (coding-standards, hve-core-all) and plugin generation appear consistent.
No blocking functional, security, or correctness findings. The templates in assets/ provide good starter scaffolding. LGTM.
bindsi
approved these changes
Jun 8, 2026
bindsi
left a comment
bindsi
left a comment
Member
There was a problem hiding this comment.
Automated batch review: no actionable findings.
rezatnoMsirhC
approved these changes
Jun 17, 2026
| @@ -571,6 +571,8 @@ items: | |||
| kind: instruction | |||
| - path: .github/instructions/shared/story-quality.instructions.md | |||
| kind: instruction | |||
Contributor
There was a problem hiding this comment.
Nit: the skill is declared maturity: stable in coding-standards.collection.yml, but this entry in hve-core-all.collection.yml omits the maturity field. Per the skill's own documentation, item-level maturity overrides collection-level maturity, so the omission could expose or suppress the skill across distribution channels differently than intended.
- path: .github/skills/coding-standards/hve-artifact-authoring
kind: skill
maturity: stable
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.
Summary
Adds the
hve-artifact-authoringskill to thecoding-standardscollection alongsidepython-foundational.The skill teaches frontmatter contracts, naming conventions, collection packaging, subagent delegation, and validation pipelines for authoring HVE Core artifacts.
Benchmark Evidence (blind A/B, 8 evals, 34 expectations)
Model: Claude Opus 4.6 (1M context)
Acceptance Criteria
hve-artifact-authoring/SKILL.mdpresent incoding-standardscollectionname:,description:,version:)validate:skillspassesCloses #1506
Part of #1504