Agent skill

Install the agent skill

Drop SKILL.md into your runtime's skills directory.

The TXLookup skill is a single Markdown file with YAML frontmatter — skills/txlookup/SKILL.md. It tells an agent runtime when to invoke TXLookup, which tool to pick, what the safe bounds are, and how to cite results.

It is portable across runtimes. The same file works in Claude Code, Codex, and Cursor.

Section

Claude Code

mkdir -p ~/.claude/skills/txlookup
cp skills/txlookup/SKILL.md ~/.claude/skills/txlookup/SKILL.md

Restart Claude Code. The skill auto-loads on session start.

Verify:

/skills

You should see txlookup in the list.

Section

Codex CLI

Codex reads skills from ~/.codex/skills/:

mkdir -p ~/.codex/skills/txlookup
cp skills/txlookup/SKILL.md ~/.codex/skills/txlookup/SKILL.md

Section

Cursor

Cursor reads skills via .cursor/skills/ at the project root:

mkdir -p .cursor/skills/txlookup
cp skills/txlookup/SKILL.md .cursor/skills/txlookup/SKILL.md

Section

What's in the file

The frontmatter:

---
name: txlookup
description: Use when an agent needs to discover, query, or summarize Texas public datasets...
license: MIT
maintainer: ATX-TXLookup
---

The body covers:

  • When to use — trigger phrases (Austin permits, Texas state expenditures, "compare X across zip codes", etc.) and explicit non-uses (no PII, no auth-walled sources, no real-time emergency data).
  • Tool catalogdiscover, describe, query, summarize, cite, with hard limits.
  • Safe-use rules — six non-negotiables. See the safety page.
  • Example invocations — three worked examples including a refusal.
  • Personas — Sarah (parent), Marcus (small-business owner), Jordan (journalist).

Section

Pair the skill with the MCP server

The skill teaches the agent the policy. The MCP server provides the implementation. Install both for the full loop — see the MCP install page.

Section

Source

skills/txlookup/SKILL.md