agents-refresh

Refresh AGENTS.md to align with repository changes and GitHub Actions workflows.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/askaret/codex-skills --skill agents-refresh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-refresh
Source: https://github.com/askaret/codex-skills/tree/main/.agents/skills/agents-refresh
Command: npx skills add https://github.com/askaret/codex-skills --skill agents-refresh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Refreshes AGENTS.md to keep guidance aligned with repository changes, workspace layout, and GitHub Actions workflows (commands, checks, repo map).

Core Features & Use Cases

  • Re-discovers commands from scripts/tooling
  • Updates the AGENTS.md with current CI gates and repo structure
  • Preserves intent and removes stale or incorrect commands

Quick Start

Run the agents-refresh task to update AGENTS.md to reflect the latest repository state.

Frequently Asked Questions about agents-refresh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update AGENTS.md when my GitHub Actions workflows change?

Use agents-refresh to update AGENTS.md when GitHub Actions workflows change. It re-discovers CI gates from .github/workflows/, extracts current commands from scripts and tooling, and conservatively updates the file to preserve structure while removing stale entries.

What is the best way to keep AGENTS.md aligned with repo structure evolution?

Run agents-refresh to keep AGENTS.md aligned with repo structure evolution. It re-discovers commands from scripts and tooling, updates the workspace layout mapping, and conservatively refreshes the guidance file to reflect repository changes while preserving existing structure.

When do I need to refresh my AGENTS.md file?

Refresh AGENTS.md when workflow files change under .github/workflows/, when build or test scripts change, or when repo structure evolves. Running agents-refresh re-discovers commands and CI gates, removing stale entries to keep guidance current with repository changes.

Does updating AGENTS.md preserve my existing workspace layout and command structure?

Yes, updating AGENTS.md preserves your existing workspace layout and command structure. The tool reads the current file, re-discovers commands from scripts and CI gates from workflows, and conservatively updates content while intentionally maintaining the original structure and intent.

How to remove stale commands from AGENTS.md after modifying test scripts?

Run agents-refresh to remove stale commands from AGENTS.md after modifying test scripts. It re-discovers current commands from scripts and tooling, compares them against the existing file, and conservatively updates the document to eliminate outdated entries while keeping valid guidance.