skills.rest
Rosetears520
Rosetears520COMMUNITY
Explore all skills by this author →
GitHub

agents-md-initialization

Create, update, and verify project-local AGENTS.md files using the AILI template workflow.

2|Updated May 3, 2026
Search Tags:#rule validation#agents-md#repository initialization#template compliance#ci gate#opencode governance
One-click install
npx skills add https://github.com/Rosetears520/aili-workflows --skill agents-md-initialization
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agents-md-initialization
Source: https://github.com/Rosetears520/aili-workflows/tree/main/skills/agents-md-initialization
Command: npx skills add https://github.com/Rosetears520/aili-workflows --skill agents-md-initialization

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you create, update, and verify the repository-local AGENTS.md using the official AILI template workflow, avoiding inconsistent or hand-written agent rules that can break OpenCode operation.

Core Features & Use Cases

  • Template-safe initialization: Ensures Project AGENTS.md is created from templates/AGENTS.md, never written from scratch.
  • Managed updates: Updates only AILI-managed blocks in an existing AGENTS.md rather than overwriting everything.
  • Compliance checking: Verifies the final AGENTS.md matches template compliance rules, suitable for a CI/pre-commit gate.
  • Use Case: When starting a new repo, initialize AGENTS.md once, then maintain it through update/check cycles as your project structure evolves.

Quick Start

Ask an AI assistant to initialize or verify your project-local AGENTS.md by running: python "$AILI_HOME/scripts/agents_md.py" init --project .

Frequently Asked Questions about agents-md-initialization

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

FAQPage Schema
How do I initialize an AGENTS.md file for a new repository?▼

To initialize an AGENTS.md file, run the provided python script to create it safely from the official AILI template, ensuring your repository has correct agent operating rules from the start without manual writing.

What is the safest way to update AGENTS.md without losing custom configurations?▼

Updating AGENTS.md safely means modifying only AILI-managed blocks rather than overwriting the entire file, which preserves your custom configurations while keeping the template compliant.

Can I use AGENTS.md compliance checks as a CI gate?▼

Yes, you can use the provided scripts to verify AGENTS.md compliance as a CI gate or pre-commit hook, ensuring your repository rules match template provenance before integration.

Why does my OpenCode project need template provenance for AGENTS.md?▼

Template provenance for AGENTS.md is required to avoid inconsistent or hand-written agent rules that can break OpenCode operation, ensuring the file originates from the correct AILI template.

Do I need to write AGENTS.md from scratch for OpenCode-enabled projects?▼

No, you should never write AGENTS.md from scratch for OpenCode-enabled projects; it must be initialized using the provided AILI template workflow to guarantee correct structure and compliance.

Related Skills

Explore More Software Engineering Skills→
tilework-techtilework-tech
149

Creating-Skills

Create custom profile skills with SKILL.md checklists and Bash scripts.

Official
Basic
adaptive-enforcement-labadaptive-enforcement-lab
3

enforce

Automate security enforcement across CI pipelines and repository governance.

Official
Advanced
tiankong0101-bytetiankong0101-byte

customize-opencode

Manage OpenCode configuration files, agents, and skill registration workflows.

Community
Intermediate
xloxn69xloxn69
7

story-skeleton

Generates a complete user story template with YAML frontmatter and markdown sections.

Community
Basic