tl-agent-skills

A curated collection of Agent Skills authored by Todd Levy for use with Cursor, Claude Code, and other agent runtimes that support the Anthropic Agent Skills specification. Each skill is a self-contained SKILL.md (with optional references/, scripts/, and assets/ folders) that gives an agent durable, composable expertise in a specific domain.

Install

Install all skills into the universal global skills directory (~/.agents/skills/):

npx skills add toddlevy/tl-agent-skills -g -y --agent universal

This is the canonical install command — use it for both fresh installs and updates. It overwrites every previously installed skill folder with the latest version from origin/main.

Skills

Plan suite

Skill	Purpose
tl-agent-plan-create	Create structured plan documents for features, projects, or multi-phase tasks.
tl-agent-plan-audit	Audit plan documents before execution and produce verification receipts.
tl-agent-plan-execute	Execute a verified plan, consuming audit receipts to avoid redundant re-verification.

Documentation suite

Skill	Purpose
tl-docs-create	Create documentation from scratch with SSOT-driven generation and writing standards.
tl-docs-audit	Audit existing documentation for gaps, staleness, and sync issues.
tl-docs-viewer-create	Build a React admin UI for browsing docs with tree navigation, markdown, and Mermaid.

OpenMeter suite

Skill	Purpose
tl-openmeter-api	Reference for the OpenMeter REST API: metering, billing, entitlements, subscriptions.
tl-openmeter-local-dev	Set up and troubleshoot OpenMeter locally with Docker, ngrok, and the Stripe app.
tl-openmeter-api-mcp-server	MCP server exposing local OpenMeter as tools for Cursor and other AI assistants.

Code quality and architecture

Skill	Purpose
tl-first-principles	Foundational software design principles traced to their intellectual origins.
tl-complexity-assessment	Find large files, god modules, and refactoring candidates in TS/JS/React codebases.
tl-knip	Find and remove unused files, dependencies, and exports using Knip.
tl-devlog	Maintain a structured DEVLOG.md capturing decisions, milestones, and incidents.

Data and integrations

Skill	Purpose
tl-kysely-patterns	Type-safe SQL query building with Kysely for PostgreSQL.
tl-pg-boss	PostgreSQL-backed job queue with exactly-once delivery via SKIP LOCKED.
tl-schema-org	The full Schema.org vocabulary with production patterns for JSON-LD, DBs, and APIs.
tl-live-music-data	Reference for live music APIs (MusicBrainz, Setlist.fm, JamBase, Bandsintown, etc.).

Rules

Alongside the skills, this repo hosts the canonical source for the tl-* Cursor rules that pair with tl-* skills. They live under rules/:

Rule	Companion skill
tl-first-principles.mdc	tl-first-principles
tl-devlog-usage.mdc	tl-devlog

Rules are a Cursor-proprietary concept and are read only from ~/.cursor/rules/ -- unlike skills, they are not part of the cross-tool Agent Skills spec and do not install into ~/.agents/. Sync the canonical rules/ folder into Cursor's global rules directory as a real copy:

.\scripts\sync-global-rules.ps1          # mirror rules/ -> ~/.cursor/rules/tl-agent-rules/
.\scripts\sync-global-rules.ps1 -Strict  # drift check (non-zero exit if out of sync)

The script copies (not symlinks) every rules/*.mdc into ~/.cursor/rules/tl-agent-rules/ and prunes any stale file left behind by a rename. Only publishable tl-* companion rules belong here; personal / operational rules are authored directly in ~/.cursor/rules/ and never enter this repo.

License & Attribution

This project is licensed under the MIT License — see the LICENSE file at the repo root and the per-skill LICENSE file inside each skills/<name>/ folder. The MIT license permits use, modification, and redistribution provided the copyright notice and license text are preserved.

Each SKILL.md carries an SPDX license header (SPDX-License-Identifier: MIT) immediately after its YAML frontmatter so the license travels with the file when individual skills are copied or vendored into other projects. Please preserve that header.

Several skills in this repo are quilted — synthesized from multiple upstream sources with per-source weights and attribution recorded in each skill's metadata.quilted block. See NOTICE for the consolidated list of upstream sources by skill.

Author

Todd Levy — <toddlevy@gmail.com> — github.com/toddlevy

Contributing

This is a single-author repository. If you find a bug or have a suggestion, open an issue at github.com/toddlevy/tl-agent-skills/issues.