skills.rest
chiubaka
chiubakaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

agents-org-md-streamline

Move review-time guidance from AGENTS.org.md into review skills or ADRs.

1|Updated Jul 7, 2022
Search Tags:#software architecture#code organization#document structuring#rule classification#guidance management
One-click install
npx skills add https://github.com/chiubaka/circleci-orb --skill agents-org-md-streamline
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agents-org-md-streamline
Source: https://github.com/chiubaka/circleci-orb/tree/main/org/agents/skills/agents-org-md-streamline
Command: npx skills add https://github.com/chiubaka/circleci-orb --skill agents-org-md-streamline

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of maintaining clear, structured, and efficient org/agents/AGENTS.org.md files by organizing content into appropriate categories and ensuring generation-time guidance is centralized.

Core Features & Use Cases

  • Content Refactoring: Moves review-time guidance to the review skill or ADRs, keeping org guidance focused on generation-time rules.
  • Rule Assessment: Provides a structured approach to classify and retain rules that impact first-pass structural correctness.
  • Guidance Handoff: Ensures a clear handoff from org guidance to review skills for post-generation quality checks.

Quick Start

Run the 'agents-org-md-streamline' skill to streamline your org/agents/AGENTS.org.md file following the specified guidelines.

Frequently Asked Questions about agents-org-md-streamline

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

FAQPage Schema
How do I separate generation-time rules from review-time guidance in AGENTS.org.md?▼

To separate generation-time rules in AGENTS.org.md, you can refactor the file by moving review-time guidance to the review skill or ADRs, ensuring a clear handoff for post-generation quality checks.

What is the best way to organize org guidance to maintain structural integrity during code review?▼

Organizing org guidance involves classifying and retaining only rules that impact first-pass structural correctness, while handing off post-generation quality checks to dedicated review skills to maintain structural integrity.

Does streamlining AGENTS.org.md require moving content to ADRs?▼

Streamlining AGENTS.org.md does involve moving certain content to ADRs, specifically relocating review-time guidance and architectural decisions away from generation-time rules.

How do I classify rules in AGENTS.org.md for code generation?▼

Classifying rules in AGENTS.org.md requires assessing whether each rule impacts first-pass structural correctness; rules that do are retained for generation, while others are moved to review skills.

When should I move guidance out of my AGENTS.org.md file?▼

You should move guidance out of your AGENTS.org.md file when it pertains to review-time checks rather than generation-time rules, handing it off to the review skill or ADRs.

Can I centralize generation-time guidance by refactoring AGENTS.org.md?▼

Yes, you can centralize generation-time guidance by refactoring AGENTS.org.md to move review-time guidance and certain content to the review skill or ADRs, keeping generation rules focused.

Related Skills

Explore More Software Engineering Skills→
RyderFreeman4LogosRyderFreeman4Logos
12

rule-extractor

Extract bug-class findings from merged PR reviews into structured coding rules.

Community
Advanced
ArieGoldkinArieGoldkin
10

architecture-decision-record

Document architectural decisions using Nygard format ADR templates.

Community
Intermediate
controlaltnerdcontrolaltnerd

adr

Create, review, and update Architecture Decision Records with status lifecycle management.

Community
Intermediate
dvy1987dvy1987
3

code-review-crsp

Review code changes for correctness, security, and requirement alignment.

Community
Advanced