# Codemod Semantic Providers

> Codemod Semantic Providers is an Agent Skill for development published in the codemod/codemod repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when changing Codemod semantic analysis providers, language-core traits, JavaScript/TypeScript provider behavior, Python provider behavior, semantic-factory routing, tree-sitter loader behavior, goto-definition, find-references, or semantic integration tests.

- Skill name: `codemod-semantic-providers`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/codemod/codemod/blob/HEAD/.agents/skills/codemod-semantic-providers/SKILL.md
- Repository: codemod/codemod (1,047 GitHub stars when collected)

## SKILL.md

# Codemod Semantic Providers

## Key Areas

- Shared traits and types: `crates/language-core`
- JavaScript/TypeScript provider: `crates/language-javascript`
- Python provider: `crates/language-python`
- Provider selection: `crates/semantic-factory`
- Parser loading: `crates/tree-sitter-loader`
- Integration tests: `crates/codemod-sandbox/tests/integration/semantic`

## Rules

- Keep `language-core` language-neutral.
- Preserve provider contracts for goto-definition, find-references, file identity, and virtual
  filesystem behavior.
- Do not silently fall back to a different semantic provider when initialization fails.
- Add fixtures for imports, aliases, workspace roots, ambiguous references, and false positives when
  behavior changes.
- JavaScript provider changes should consider OXC resolver and Yarn PnP behavior.
- Python provider changes should keep Ruff/ty integration narrow and version-aware.
- Do not print directly to stdout/stderr from provider code. Return diagnostics or errors to callers
  so `crates/cli` can preserve TUI and JSONL output modes.

## Validation

- Provider crates:
  `cargo test -p language-core -p language-javascript -p language-python -p semantic-factory`
- Sandbox semantic integration: `cargo test -p codemod-sandbox semantic`
- Factory only: `cargo test -p semantic-factory`

---

Source: https://www.openparable.com/skill/development/codemod-semantic-providers (OpenParable). Cite the canonical URL above.
