AGENTS.md

AGENTS.md

Guidelines for AI agents working in this repository.

Repository Overview

This repository contains **Agent Skills** for AI agents following the [Agent Skills specification](https://agentskills.io/specification.md). Skills install to `.agents/skills/` (the cross-agent standard). This repo also serves as a **Claude Code plugin marketplace** via `.claude-plugin/marketplace.json`.

• Name: Marketing Skills
• GitHub: coreyhaines31/marketingskills
• Creator: Corey Haines
• License: MIT

Repository Structure

marketingskills/
├── .claude-plugin/
│   └── marketplace.json   # Claude Code plugin marketplace manifest
├── skills/                # Agent Skills
│   └── skill-name/
│       └── SKILL.md       # Required skill file
├── tools/
│   ├── clis/              # Zero-dependency Node.js CLI tools (51 tools)
│   ├── composio/          # Composio integration layer (quick start + toolkit mapping)
│   ├── integrations/      # API integration guides per tool
│   └── REGISTRY.md        # Tool index with capabilities
├── CONTRIBUTING.md
├── LICENSE
└── README.md

Build / Lint / Test Commands

**Skills** are content-only (no build step). Verify manually:

• YAML frontmatter is valid
• name field matches directory name exactly
• name is 1-64 chars, lowercase alphanumeric and hyphens only
• description is 1-1024 characters

**CLI tools** (`tools/clis/*.js`) are zero-dependency Node.js scripts (Node 18+). Verify with:

node --check tools/clis/.js   # Syntax check
node tools/clis/.js           # Show usage (no args = help)
node tools/clis/.js  --dry-run  # Preview request without sending

Agent Skills Specification

Skills follow the [Agent Skills spec](https://agentskills.io/specification.md).

Required Frontmatter

---
name: skill-name
description: What this skill does and when to use it. Include trigger phrases.
---

Frontmatter Field Constraints

Field	Required	Constraints
name	Yes	1-64 chars, lowercase a-z, numbers, hyphens. Must match dir.
description	Yes	1-1024 chars. Describe what it does and when to use it.
license	No	License name (default: MIT)
metadata	No	Key-value pairs (author, version, etc.)

Name Field Rules

• Lowercase letters, numbers, and hyphens only
• Cannot start or end with hyphen
• No consecutive hyphens (--)
• Must match parent directory name exactly

**Valid**: `page-cro`, `email-sequence`, `ab-test-setup` **Invalid**: `Page-CRO`, `-page`, `page--cro`

Optional Skill Directories

skills/skill-name/
├── SKILL.md        # Required - main instructions (<500 lines