Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Empty file added .claude/skills/.gitkeep
Empty file.
11 changes: 11 additions & 0 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
## What this changes

<!-- One or two sentences. Name the skill or agent. -->

## 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: <!-- assistant and model -->
30 changes: 30 additions & 0 deletions .github/workflows/validate.yml
Original file line number Diff line number Diff line change
@@ -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
12 changes: 12 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -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
23 changes: 23 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -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>/SKILL.md`: one skill per folder. `skills/_template/` is the starting point.
- `agents/<agent>/`: 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.
1 change: 1 addition & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
@AGENTS.md
7 changes: 7 additions & 0 deletions CODEOWNERS
Original file line number Diff line number Diff line change
@@ -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.
#
# * @<human-lead-github-handle>
# /skills/ @<human-lead-github-handle>
# /agents/ @<human-lead-github-handle>
25 changes: 25 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -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/<your-skill>/`. 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.
38 changes: 38 additions & 0 deletions MANIFESTO.md
Original file line number Diff line number Diff line change
@@ -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
29 changes: 29 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -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/<skill>/`. 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>/`.

| 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.
27 changes: 27 additions & 0 deletions agents/lion/AGENT.md
Original file line number Diff line number Diff line change
@@ -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.
6 changes: 6 additions & 0 deletions agents/lion/README.md
Original file line number Diff line number Diff line change
@@ -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
13 changes: 13 additions & 0 deletions agents/lion/agent.yaml
Original file line number Diff line number Diff line change
@@ -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
19 changes: 19 additions & 0 deletions skills/_template/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Your Skill Name

What this skill does, in two sentences.

## Video

<!-- Link to a short demo. -->

## Install

Copy this folder into your assistant's skills directory.

## Dependencies

<!-- Tools, connectors, or other skills this one needs. Write "None" if none. -->

## Example

<!-- A sample request and what comes back. -->
33 changes: 33 additions & 0 deletions skills/_template/SKILL.md
Original file line number Diff line number Diff line change
@@ -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.
Loading