Skip to content

Add repo config audit guidance - #58

Open
FarPointer wants to merge 1 commit into
mainfrom
repo-config-audit-guidance
Open

Add repo config audit guidance#58
FarPointer wants to merge 1 commit into
mainfrom
repo-config-audit-guidance

Conversation

@FarPointer

Copy link
Copy Markdown
Owner

Summary

  • add repo-level guidance for configuration and workflow recommendation requests
  • add a repo-specific repo-config-audit skill for setup and instruction audits
  • document the new skill and its recommendation-first boundary in the skills README

Testing

  • not run (instruction and skill text changes only)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI lite review requested due to automatic review settings August 10, 2026 00:26

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 repo-level guidance and a new skill to standardize how configuration/workflow recommendation requests are handled by agents, ensuring audits start from the repository’s actual instruction surfaces and stay recommendation-first until explicitly asked to implement.

Changes:

  • Expanded AGENTS.md with guidance for recommendation-first workflows and a new section describing how repo-level instructions vs. skills should be structured.
  • Added a new repo-specific skill, repo-config-audit, to audit instruction/skill/agent setup and produce evidence-backed recommendations.
  • Documented the new skill and its recommendation-only boundary in the skills index README.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
AGENTS.md Adds repo-level guidance for configuration/workflow recommendation requests and clarifies where instruction doctrine should live.
.github/skills/repo-config-audit/SKILL.md Introduces a new skill defining a concrete, evidence-based audit workflow and deliverable for repo configuration advice.
.github/skills/README.md Registers and explains the new repo-config-audit skill and its recommendation-first boundary.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread AGENTS.md
Comment on lines +64 to +65
read `AGENTS.md`, relevant `.github/instructions/*.instructions.md`, `.github/skills/`,
`.github/agents/`, and the checked-in operating docs before recommending changes.
1. `AGENTS.md`
2. Relevant `.github/instructions/*.instructions.md`
3. `.github/skills/README.md` and any skills implicated by the request
4. `.github/agents/` if the request mentions agents or role prompts
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.

2 participants