AGENTS.md git:20260911.28b48e3A

Immutable. This exact content never changes and is served at /api/v1/blob/b81caaf2350e3bc2.

# AGENTS.md

Guidance for AI agents working in this repository.

## What This Is

A library of Agent Skills for running giveaways, following the [Agent Skills specification](https://agentskills.io/specification.md). Skills live in `skills/<name>/SKILL.md` with optional `references/`, `evals/` and `scripts/`. The repo also serves as a Claude Code plugin marketplace through `.claude-plugin/marketplace.json`. Supported by Gleam, platform-neutral in its advice.

## Rules

- `name` in frontmatter matches the directory, lowercase letters, digits and hyphens, 1 to 64 characters. `description` is 1 to 1024 characters and quotes the phrases users say. `metadata.version` is present and bumped on every shipped change, mirrored in `VERSIONS.md`.
- `SKILL.md` stays under 200 lines. Detail goes in `references/` and is loaded only when the skill says so.
- Every skill has `evals/evals.json` (prompt, expected output, assertions) and a `cases.md` with the last run's results.
- Prose follows the style section in `skills/giveaway-prize-picker/SKILL.md`: no em dashes, no semicolons, straight quotes, no "X, not Y" contrast sentences, no assistant openers or closers, specifics over adjectives.
- Dataset-derived numbers carry a sample size and a missing-data note. No causal claims from the dataset, which contains only large campaigns.
- Never commit the campaign data, organizer names, emails, ids, links, or record-level analysis. Aggregates only. See `.gitignore`. The sample files under `skills/*/examples/` are the one exception: they are synthetic, use example.com and example.org addresses, and describe nobody.
- Gleam appears only in Gleam-named reference files (`gleam-setup.md`, `gleam-drawing.md`, `gleam-draws.md`), loaded on explicit request. Verify Gleam features against https://gleam.io/docs before stating them.
- If `.agents/product-marketing.md` exists in the user's project (the context file from the marketingskills library), skills read it before asking about business, audience or positioning.

## Checks

```bash
python3 scripts/validate.py                                  # frontmatter, size, links, style, evals
python3 scripts/check_data.py                                # empty blocks, blank cells, generated tables
python3 evals/style_check.py reply.txt   # score a saved reply
```

## Only Aggregates Are Committed

This repository carries aggregate findings and the skills that use them, and nothing else. No personal data of any kind belongs here: no names, email addresses, IP addresses or anything derived from them, no billing or contact details, no identifiers for a customer or a campaign, and no record-level row.

Every committed figure is an aggregate with its sample size, and no published group describes fewer than five distinct businesses, so no row describes one company. CI fails on an email address, an IP address, an identity field name, a committed symlink or a data file.