README.md

title	Contributing AI Artifacts
description	Guides for contributing agents, instructions, and prompts to hve-core
sidebar_position	1
author	Microsoft
ms.date	2026-02-06
ms.topic	overview
keywords	contributing agents instructions prompts ai artifacts
estimated_reading_time	2

Guidelines and standards for contributing AI artifacts to hve-core.

Finding the Right Guide

Use this table to navigate to the appropriate guide based on what you want to contribute:

I want to...	Start here
Report a bug or suggest an enhancement	CONTRIBUTING.md
Submit a code change	CONTRIBUTING.md
Improve general documentation	CONTRIBUTING.md
Create or modify an agent	Custom Agents
Create or modify an instruction file	Instructions
Create or modify a prompt	Prompts
Create or modify a skill	Skills
Understand shared AI artifact standards	Common Standards
Learn about the release process	Release Process
Check CI and review requirements	Branch Protection
See the project roadmap	Roadmap

Contribution Guides

Guide	Description
Common Standards	Shared conventions, quality gates, and rejection criteria for all contributions
Custom Agents	How to create and submit new agent definitions
Instructions	How to create repository-specific coding guidelines
Prompts	How to create reusable prompt templates
Skills	How to create skill packages with scripts and documentation
Release Process	Extension channels, maturity levels, and publishing workflow

Before You Start

1. Read the Common Standards first - it defines quality gates that apply to all artifact types
2. Check existing artifacts in .github/ to avoid duplicating functionality
3. Review the main Contributing Guide for general contribution process

Quick Links

• Agents Directory
• Instructions Directory
• Prompts Directory
• Skills Directory

---

🤖 Crafted with precision by ✨Copilot following brilliant human instruction, then carefully refined by our team of discerning human reviewers.