elternportal-skill

A collection of Agent Skills for Eltern-Portal school websites.

Works with Claude Code, Cursor, VS Code Copilot, and any Agent Skills-compatible tool.

Skills

Vertretungsplan

• Fetches the current substitution plan for your child's class
• Uses Claude Haiku to extract structured JSON from the HTML
• Presents a clean, human-readable summary

Elternbriefe

• Lists all available parent letters (Elternbriefe) with metadata
• Downloads individual letters by title or number
• Converts PDF attachments to markdown for easy reading
• Handles text-only entries (no PDF) as well

Example output

Vertretungsplan Klasse 6C (Stand: 16.03.2026 07:41:22)

Mo., 16.03.2026 (KW 12)
| Std. | Absent | Substitute | Subject     | Room | Info        |
|------|--------|------------|-------------|------|-------------|
| 6.   | Ru     | Pb         | D_1 → G     | A105 | Vertretung  |

Di., 17.03.2026 (KW 12)
| Std. | Absent | Substitute | Subject         | Room | Info                 |
|------|--------|------------|-----------------|------|----------------------|
| 6.   | Hp     | Sm         | Mu_1 → NuT_1   | A105 | -Natur und Technik!  |

Installation

Option 1: skills.sh CLI (recommended)

npx add-skill https://github.com/andasv/elternportal-skill

Option 2: Manual

# Clone the repo
git clone https://github.com/andasv/elternportal-skill.git

# Copy the skill into your project or personal skills directory
cp -r elternportal-skill/skills/elternportal-vertretungsplan .claude/skills/
cp -r elternportal-skill/skills/elternportal-elternbriefe .claude/skills/
# or for all projects:
cp -r elternportal-skill/skills/elternportal-vertretungsplan ~/.claude/skills/
cp -r elternportal-skill/skills/elternportal-elternbriefe ~/.claude/skills/

Install Python dependencies

pip3 install requests beautifulsoup4 python-dotenv anthropic pymupdf

Configuration

Create a .env file in your project root (see .env.example):

URL=https://YOURSCHOOL.eltern-portal.org
USER=your@email.com
PASSWORD=your-password
ANTHROPIC_API_KEY=sk-ant-...

Find your school's URL by logging into Eltern-Portal — it follows the pattern https://SCHOOLCODE.eltern-portal.org.

Usage

Vertretungsplan

/elternportal-vertretungsplan

Or just ask Claude about substitutions, schedule changes, or Vertretungsplan.

Elternbriefe

/elternportal-elternbriefe

Or ask Claude to look up a specific parent letter, e.g. when you receive an email notification about a new Elternbrief.

Compatibility

• Python 3.10+
• Claude Code, Cursor, VS Code Copilot, and other Agent Skills-compatible tools
• Any school using the Eltern-Portal platform (eltern-portal.org)

License

MIT