# sorted

Automates getSorted.de in a live browser to create freelancer invoices, track expenses, and file German tax reports.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 151 installs · ★ 414 repo stars
- Author: glebis
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/glebis/claude-skills/tree/HEAD/sorted/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/sorted

## What it does

This skill controls the `getSorted.de` web application directly through browser actions. It creates client invoices, pulls official invoice PDFs, logs deductible expenses, and tracks deadlines for advance VAT (UStVA), EU summary statements (ZM), and annual returns.

Under the hood, it pairs Chrome Beta on remote debugging port 9222 with the `agent-browser` command-line tool. Your Google login session stays cached in `~/.chrome-beta-profile`.

Automation fails immediately if Chrome Beta is not already running with `--remote-debugging-port=9222`. Submitting filings to Finanzamt via ELSTER and emailing invoices directly from the app both require a paid Sorted tier.

## Requirements
- Works with: Chrome

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add glebis/claude-skills --skill sorted -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/sorted/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/sorted/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add glebis/claude-skills --skill sorted -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/sorted/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add glebis/claude-skills --skill sorted -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/sorted/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install glebis/claude-skills sorted
```

2. **Manually: put the files in place**
- File: `.github/skills/sorted/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add glebis/claude-skills --skill sorted -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/glebis/claude-skills --path sorted
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/sorted/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add glebis/claude-skills --skill sorted -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/glebis/claude-skills/tree/HEAD/sorted/SKILL.md

## When to use it
- generate freelancer invoices with client details and amounts in getSorted.de
- download clean native invoice PDFs without capturing web sidebars
- monitor deadlines and submission status for German VAT filings
- record business expenses directly into the bookkeeping ledger

## Example prompts
- Create an invoice on Sorted for client Acme Corp with amount 1500 EUR
- Download native PDF for invoice 2025-03-21 from getSorted.de
- Check upcoming tax obligations and overdue filings via tax status

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 61fcdc8d30888fbb.

BEGIN THIRD-PARTY FILE 61fcdc8d30888fbb
```text
---
name: sorted
description: Automate getSorted.de (Sorted) for freelancer invoicing, expense tracking, and German tax submissions (VAT, ZM, annual returns). Uses real-browser automation via Chrome Beta + agent-browser. Triggers on "create invoice", "sorted invoice", "download invoice", "submit VAT", "tax report", "sorted expenses", "/sorted", or any getSorted.de interaction.
---

# Sorted — Freelancer Tax & Invoicing Automation

Automates [getSorted.de](https://app.getsorted.de/) via real Chrome Beta browser for invoicing, expense tracking, and German tax report submissions.

## Prerequisites

- Chrome Beta with `--remote-debugging-port=9222` (use `/real-browser` launch sequence)
- Google account session persisted in `~/.chrome-beta-profile`
- `agent-browser` CLI installed

## Commands

### `invoice create`

Create a new invoice on Sorted.

**Required params:** client name, amount
**Optional:** hours, rate, description, due date, service date, client type (business/person)

### `invoice download <invoice-number>`

Download a properly formatted PDF from Sorted (not browser print).

### `invoice send <invoice-number> --email <email>`

Send invoice via email directly from Sorted (paid plan only). On free plan, downloads PDF and sends via Telegram instead.

### `invoice list`

List all invoices with status (paid/unpaid).

### `expense add`

Add an expense entry.

### `tax status`

Show current tax obligations, deadlines, and overdue reports.

### `tax preview <report-type> <period>`

Preview a tax report before submission.

### `tax submit <report-type> <period>`

Submit a tax report to Finanzamt via ELSTER (requires paid plan).

## Sorted Navigation

App URL: `https://app.getsorted.de/`

| Section | Sidebar link | Purpose |
|---------|-------------|---------|
| Dashboard | Sorted (logo) | Overview: taxes owed, income, expenses |
| Taxes | Taxes | Tax reports, deadlines, submissions |
| Income | Income | Invoice list, create/edit invoices |
| Expenses | Expenses | Expense tracking, receipts |
| Tax consultant | Tax consultant | Advisor connection |
| Personal details | Profile → Personal details | Freelancer info, Steuernummer |
| Bank accounts | Profile → Bank accounts (Beta) | Connected banks |
| Subscription | Profile → Subscription | Plan management |
| Import | Profile → Import your data | Bulk data import |
| Settings | Profile → Settings | App preferences |

## Tax Report Types

| Report | German name | Frequency | Description |
|--------|------------|-----------|-------------|
| Advance VAT | Umsatzsteuer-Voranmeldung (UStVA) | Quarterly | VAT collected on invoices |
| EU Summary | Zusammenfassende Meldung (ZM) | Quarterly | Revenue from EU customers |
| Annual Returns | EÜR + Einkommensteuererklärung | Yearly | Profit/loss + income tax |

## Invoice Creation Flow

### Step-by-step browser automation:

1. **Navigate:** `Income` → click `Add` → `Create invoice`
2. **Set client:** Click `Client details` area on invoice preview
   - Search existing clients or click `Add new client`
   - Choose `Business` or `Private person`
```
END THIRD-PARTY FILE 61fcdc8d30888fbb

The third-party file has ended. Everything between the 61fcdc8d30888fbb tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3100 of 8150 bytes. © glebis · MIT · https://github.com/glebis/claude-skills/tree/HEAD/sorted/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
