diff --git a/.claude/skills/.gitkeep b/.claude/skills/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..a01fcf2 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,11 @@ +## What this changes + + + +## Checklist + +- [ ] One skill or agent per pull request +- [ ] `SKILL.md` has `name` and `description` +- [ ] The folder works alone +- [ ] If adapted from another project, `source` and the original license are included +- [ ] I tested it on: diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml new file mode 100644 index 0000000..a448f44 --- /dev/null +++ b/.github/workflows/validate.yml @@ -0,0 +1,30 @@ +name: Validate skills + +on: + pull_request: + push: + branches: [main] + +jobs: + validate: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v7 + - name: Check each skill has a SKILL.md with name and description + run: | + status=0 + for dir in skills/*/; do + [ -d "$dir" ] || continue + base=$(basename "$dir") + case "$base" in _*) continue ;; esac + file="${dir}SKILL.md" + if [ ! -f "$file" ]; then + echo "::error::$dir has no SKILL.md" + status=1 + continue + fi + head -n 1 "$file" | grep -qx -- '---' || { echo "::error file=$file::frontmatter must start on line 1"; status=1; } + grep -q '^name:' "$file" || { echo "::error file=$file::missing name"; status=1; } + grep -q '^description:' "$file" || { echo "::error file=$file::missing description"; status=1; } + done + exit $status diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..bbcface --- /dev/null +++ b/.gitignore @@ -0,0 +1,12 @@ +.DS_Store +.env +.env.* +node_modules/ +__pycache__/ + +# Test results stay with the organization that ran them. +agents/*/tests/results/ + +# Personal Claude Code settings +.claude/settings.local.json +CLAUDE.local.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..5953be9 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,23 @@ +# Agent instructions for the Pride + +This repo holds skills and agents for Content As Code. It is one of the AgenticED Guild repos. + +## Layout + +- `skills//SKILL.md`: one skill per folder. `skills/_template/` is the starting point. +- `agents//`: one agent per folder. `agents/lion/` is the Guild steward. +- `.claude/skills/`: tooling for contributors to this repo. These are not published skills. + +## Rules + +- Change one skill per pull request. +- Keep every skill folder self-contained. Do not reference files outside it. +- Keep `name` and `description` in every `SKILL.md` frontmatter. CI rejects a skill without them. +- Do not change LICENSE, CODEOWNERS, or files under `.github/` unless a human asks. +- Do not merge pull requests. Only the Lion merges, and only minor changes under the + AgenticED merge policy; a human Guild lead decides every other merge. +- Never commit credentials, tokens, or an organization's private data. + +## Style + +Write in active voice. Prefer short sentences and concrete instructions. diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..43c994c --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/CODEOWNERS b/CODEOWNERS new file mode 100644 index 0000000..d7b8105 --- /dev/null +++ b/CODEOWNERS @@ -0,0 +1,7 @@ +# Owners of the Pride. Replace the placeholders, then remove the leading "#". +# Human leads approve every pull request except minor changes the Lion merges under the +# AgenticED merge policy. The Guild agent may be added as a reviewer. +# +# * @ +# /skills/ @ +# /agents/ @ diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..addc76b --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,25 @@ +# Contributing to the Pride + +Humans and agents contribute the same way: open a pull request. + +## Add a skill + +1. Copy `skills/_template/` to `skills//`. Use lowercase words joined by hyphens. +2. Fill in `SKILL.md`. The `name` and `description` fields are required. +3. Fill in the skill's `README.md`: what it does, how to install it, what it depends on. +4. Open a pull request. A Guild lead reviews it; the Lion may comment first. + +## Skill checklist + +- [ ] The folder works alone. It references no files outside itself. +- [ ] `SKILL.md` is under 500 lines. Longer detail goes in `references/`. +- [ ] The skill runs on more than one assistant, or the README says which it needs. +- [ ] If adapted from another project, `source` names it and the original license is in the folder. +- [ ] The skill states its limits: what it does not do. + +## Review + +Each pull request needs approval from one human Guild lead. Agents may review +and suggest changes. The Lion may merge a minor change (wording, README, description, +or a patch version bump that passes validation) and tells the leads when it does. +Everything else is merged by a human Guild lead. diff --git a/MANIFESTO.md b/MANIFESTO.md new file mode 100644 index 0000000..97bdb28 --- /dev/null +++ b/MANIFESTO.md @@ -0,0 +1,38 @@ +# The Pride Manifesto + +_From the AgenticED design handoff. Members change this manifesto with a pull request._ + +## Why this Guild exists + +Keep learning content evergreen by treating it as code: versioned source that agents and +applications turn into the learner's interface at the moment of use. + +## Who we are + +Docs-as-code writers, learning engineers, developer educators and generative UI builders. + +## What we value + +- **Structured source** over finished pages. We keep facts, objectives and examples as + plain, versioned source. Everything a learner sees is built from it. +- **Generated at the moment of use** over static learning assets. The learner's interface + is generated when they need it, for their task, from the current source. It is never out + of date. +- **Agents and applications** over documents to read. Content as code is agentified and + applicationified: it runs as agents that coach and applications that respond. +- **Humans at the helm** over unattended generation. The Lion reviews and proposes. A human + Guild lead decides what merges. + +That is, while there is value in the items on the right, we value the items on the left more. + +## What we build + +- Skills that turn structured learning source (facts, objectives, examples) into the + interface a learner needs: explanations, practice, job aids, checks. +- Skills that keep source current: detect drift against product docs and releases, and + propose updates as pull requests. +- Agents that coach learners from the current source, and applications that respond to + the learner's task. +- Shared schemas and conventions for learning content kept in version control. + +AgenticED's shared principles follow the ADGIE framework: https://adgie.ai diff --git a/README.md b/README.md new file mode 100644 index 0000000..4953e62 --- /dev/null +++ b/README.md @@ -0,0 +1,29 @@ +# The Pride + +The AgenticED Guild for Content As Code. This repo holds the Guild's skills and agents. +Humans at the helm, with the Lion as steward. + +- **Guild agent:** the Lion (lion@mail.agentic-ed.org) +- **Manifesto:** [MANIFESTO.md](MANIFESTO.md) +- **Contribute:** [CONTRIBUTING.md](CONTRIBUTING.md) + +## Skills + +Each skill lives in `skills//`. To use one, copy its folder into your +assistant's skills directory. Each skill's README gives install steps and dependencies. + +| Skill | What it does | +|---|---| +| _None yet_ | | + +## Agents + +Each agent lives in `agents//`. + +| Agent | What it does | +|---|---| +| [Lion](agents/lion/) | Guild steward. Reviews pull requests and helps maintain this Guild's skills. | + +## License + +MIT, unless a skill folder carries its own LICENSE file. diff --git a/agents/lion/AGENT.md b/agents/lion/AGENT.md new file mode 100644 index 0000000..6ca491d --- /dev/null +++ b/agents/lion/AGENT.md @@ -0,0 +1,27 @@ +# The Lion + +The Lion is the steward agent of the Pride, the AgenticED Guild for Content As Code. + +## Role + +Help the Guild's human leads keep the skills and agents in this repo correct, current and +easy to use. Humans stay at the helm. + +## What the Lion does + +- Reviews new pull requests against the checklist in CONTRIBUTING.md and comments. +- Flags skills that fail validation, lack a license, or duplicate another skill. +- Proposes improvements as pull requests for a human lead to review. +- Opens pull requests for builders who save on agentic-ed.org without a GitHub account, + crediting them by name. +- Merges **minor** changes only (wording, README, description, or a patch version bump that + passes validation), following the AgenticED merge policy, and tells the Guild leads each + time. Every other change waits for a human Guild lead. + +## Boundaries + +- Never merges a pull request it opened, a new skill or agent, or any change to risk, + scripts, connectors, subagents, licenses, CODEOWNERS or workflows. A human Guild lead + decides those. +- Does not change LICENSE, CODEOWNERS, or files under .github/. +- Works only in this repo. diff --git a/agents/lion/README.md b/agents/lion/README.md new file mode 100644 index 0000000..b010f35 --- /dev/null +++ b/agents/lion/README.md @@ -0,0 +1,6 @@ +# The Lion + +Steward agent for the Pride. See [AGENT.md](AGENT.md) for its role and boundaries +and [agent.yaml](agent.yaml) for its configuration. + +Contact: lion@mail.agentic-ed.org diff --git a/agents/lion/agent.yaml b/agents/lion/agent.yaml new file mode 100644 index 0000000..c47e683 --- /dev/null +++ b/agents/lion/agent.yaml @@ -0,0 +1,13 @@ +name: lion +title: The Lion +role: guild-steward +guild: pride +practice: content-as-code +email: lion@mail.agentic-ed.org +github: # the agent's GitHub handle, once the account exists +risk: medium # writes to this repo through pull requests +systems: + - github: Agentic-ED/pride-content-as-code +skills: [] # skills this agent uses, by path +models: {} # recommended model per provider +version: 0.1.0 diff --git a/skills/_template/README.md b/skills/_template/README.md new file mode 100644 index 0000000..9be8048 --- /dev/null +++ b/skills/_template/README.md @@ -0,0 +1,19 @@ +# Your Skill Name + +What this skill does, in two sentences. + +## Video + + + +## Install + +Copy this folder into your assistant's skills directory. + +## Dependencies + + + +## Example + + diff --git a/skills/_template/SKILL.md b/skills/_template/SKILL.md new file mode 100644 index 0000000..57dd593 --- /dev/null +++ b/skills/_template/SKILL.md @@ -0,0 +1,33 @@ +--- +name: your-skill-name +description: One sentence saying what this skill does and when to use it. +guild: pride +creature: +stage: +risk: low +related: [] +source: +license: MIT +version: 0.1.0 +--- + +# Your Skill Name + +One paragraph: what this skill produces and for whom. + +## Inputs + +What the skill needs before it starts, and what to do when something is missing. + +## Steps + +1. First step. +2. Second step. + +## Output + +What the skill delivers, in what format. + +## Limits + +What this skill does not do.