Azure / Azure/azure-sdk-for-python

Add an agent-maintained skill to keep repo docs up to date

Open
#48,112 0 comments 1 reaction 1 assignee Claimed by @msyyc View on GitHub
Docs
Dominant language
Python
Stars
5.6k
Forks
3.4k
Avg merge
1d 21h
Merged PRs (30d)
193

Description

## Motivation

Agents (Copilot, MCP-based assistants, etc.) increasingly perform tasks in this repo by reading the docs and instructions we ship (`AGENTS.md`, `.github/copilot-instructions.md`, `.github/skills/`, `doc/dev/`, etc.). The quality of those docs directly affects the agent''s success rate: if the docs are stale, incomplete, or inconsistent with the current code/tooling, the agent gets the wrong info and produces worse results.

If we can **refresh and check the docs in time**, an agent can pull the right information straight from the repo and complete tasks more reliably.

## Proposal

Create a **skill (or reusable pattern)** that leverages an agent to keep this repo''s docs up to date. This skill will be **written and maintained by the agent itself** — the agent decides the checklist, method, and solutions for keeping docs accurate and self-consistent.

## Goal

Improve agent task success rate by ensuring repo docs are accurate, current, and self-consistent — so agents get the right info directly from the repo.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.