agent-skills AGENTS.md

AGENTS.md

This file provides guidance to AI coding agents (Claude Code, Cursor, Copilot, Cline, etc.) when working with code in this repository.

Repository Overview

A collection of agent skills published by carofi-auto. Each skill packages domain knowledge into a format that AI coding agents can install and use automatically.

Skills are plain markdown — no build step, no dependencies.

Directory Structure

carofi-auto/agent-skills/
├── README.md               # skill directory and install commands
├── AGENTS.md               # this file
├── CLAUDE.md               # Claude Code-specific guidance (same content)
├── LICENSE                 # MIT
└── {skill-name}/           # one directory per skill, kebab-case
    ├── SKILL.md            # required: skill definition and instructions
    └── references/         # optional: supporting docs read on demand
        └── {topic}.md

Adding a New Skill

1. Create the skill directory

Use kebab-case. The directory name becomes the --skill argument at install time.

{skill-name}/
├── SKILL.md
└── references/         # add only if SKILL.md would exceed ~400 lines without it
    └── {topic}.md

2. Write SKILL.md

Required frontmatter:

---
name: {skill-name}
description: "{One sentence written as a trigger condition — when should an agent activate this skill? Include key nouns: library names, env var names, domain terms.}"
---

Body structure (adapt sections to the skill's complexity):

# {Skill Title}

> **Attribution:** {Credit the upstream source if this skill is built on
> official documentation. Link to the source.}

Brief one-paragraph description of what this skill covers.

## When this skill activates

- Bullet list of concrete trigger signals (env vars, keywords, file patterns)

## Non-negotiable rules

Numbered list of rules the agent must enforce regardless of user intent.
Security rules, data integrity rules, and irreversibility warnings belong here.

## Before writing any integration code

Table mapping tasks to reference files (if references/ exists).

## {Any domain-specific sections}