microsoft / microsoft/agent-framework

[Feature]: Feature/RFC: Meta Skill Authoring API for generating standards-compliant SKILL.md files

Open
#6,560 0 comments 3 reactions 1 assignee View on GitHub

@sphenry is already working on this.

Since Jun 18, 2026.

needs_pm skills
Dominant language
Python
Stars
13.6k
Forks
2.3k
Avg merge
2d 45m
Merged PRs (30d)
358

Description

## Feature/RFC: Meta Skill authoring for `SKILL.md`

I’d like to propose a small authoring-oriented capability for Meta Skills in Microsoft Agent Framework: helping an agent generate, validate, write, and evaluate a standards-compliant `SKILL.md`.

This is different from the existing runtime/provider work in #6301. That work focuses on loading and running skills from file-based, programmatic, class-based, MCP, `skill-md`, `archive`, and `resource-template` sources. This proposal sits one layer earlier: helping agents create valid skills in the first place.

The main idea is a lightweight lifecycle like:

```text
generate -> validate -> write -> eval
```

My main question is whether this kind of Meta Skill authoring layer belongs in Microsoft Agent Framework at all, or whether maintainers would see it as better suited for a separate companion package.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.