init

Create or update AGENTS.md with build, lint, run, and test commands.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/oElberte/dotfiles --skill init-oelberte
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init
Source: https://github.com/oElberte/dotfiles/tree/main/private_dot_factory/plugins/cache/factory-plugins/core/c13216265ee9/skills/init
Command: npx skills add https://github.com/oElberte/dotfiles --skill init-oelberte

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It reduces the time and confusion future instances spend reading an unknown codebase by generating a tailored AGENTS.md entry point that explains how to work in the repository.

Core Features & Use Cases

  • AGENTS.md bootstrap: Creates AGENTS.md when missing or proposes updates when it already exists, using the existing repository’s documentation and structure.
  • Operational commands: Documents the build, lint, and run workflow, including how to run a single test, so new agents can act immediately.
  • Architecture orientation: Summarizes the high-level code architecture and how key parts fit together, focusing on the cross-file understanding required to become productive quickly.
  • Context-aware inclusion: Incorporates important instructions from existing README.md and any Cursor/Copilot/CLAUDE instruction files when present, without adding generic guidance.

Quick Start

Run the skill to analyze the current codebase and generate an AGENTS.md that future instances can use to build, lint, run, and test efficiently.

Frequently Asked Questions about init

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

FAQPage Schema
How do I generate an AGENTS.md file for repository onboarding?

Generating an AGENTS.md file for repository onboarding requires running the skill to analyze existing repository files and README documentation. It proposes tailored contents covering build, lint, run, and single-test commands for confirmation before writing the file.

What is an AGENTS.md file used for in a codebase?

An AGENTS.md file is used in a codebase to provide automated agents with immediate, codebase-specific context. It explains high-level code architecture and operational commands so new instances can build, lint, run, and test efficiently without reading the entire repository.

Can I update an existing AGENTS.md file without losing context from my README?

You can update an existing AGENTS.md file without losing context because the skill incorporates important instructions from your existing README.md and Cursor or Copilot instruction files. It proposes updates for confirmation rather than blindly overwriting your documentation.

Does the generated AGENTS.md include how to run a single test command?

The generated AGENTS.md includes operational commands for how to run a single test. It documents the build, lint, and run workflow specifically so new agents can execute targeted tests and act immediately within the repository architecture.

What's the best way to document code architecture for automated agents?

Documenting code architecture for automated agents is best achieved by creating an AGENTS.md entry point. It summarizes high-level architecture and cross-file relationships, incorporating existing instructions from README and agent-rule files without adding generic guidance.

When should I not overwrite an existing AGENTS.md file during generation?

You should not overwrite an existing AGENTS.md file during generation because the skill uses conditional write behavior. It only writes when the file is missing, or after presenting proposed contents for your explicit confirmation to prevent data loss.