# Sym

> List Python symbols (classes/functions) quickly via AST to discover real identifiers before using `def`/`ctx`.

- Skill: `majiayu000/sym` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/sym`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/sym/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/sym

---


# sym

## Use this skill when
- You need candidate symbol names fast (avoid guessing / placeholder names).
- You want a compact index of classes/functions in a package.

## Commands

```sh
# List top-level symbols under a directory (fast)
sym .

# Focus on a package / subdir
sym mypkg

# Include class methods (more output)
sym mypkg --include-methods

# Filter by name and kind
sym mypkg --query trainer --kind class

# Filter classes by base class (e.g. nn.Module)
sym mypkg --base nn.Module --kind class

# Filter by decorator (e.g. dataclasses.dataclass / dataclass)
sym mypkg --decorator dataclass --kind class

# Include nested defs (rarely needed)
sym mypkg --include-nested --query inner

# If you filter for methods, methods are automatically included
sym mypkg --query __init__ --kind method

# Output JSON (for tooling)
sym mypkg --json

# (fallback if wrappers are not on PATH)
CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
python3 "$CODEX_HOME/skills/sym/scripts/sym.py" mypkg
```

## Notes
- AST-based: precise (low false positives) for Python.
- Bounded: respects `--max-files`, `--max-results`, and `--max-file-bytes`.