Techdebt
Find and report technical debt in the codebase
- Type
- Slash Command
- Repository
- oliver-kriska/claude-elixir-phoenix
- GitHub stars
- 556
- License
- MIT
- Repo last updated
- Sep 25, 2026
- Source file
- .claude/commands/techdebt.md
What Techdebt is
Techdebt is a slash command published in the oliver-kriska/claude-elixir-phoenix repository on GitHub, which has about 556 stars. The repository describes itself as: “Claude Code plugin for Elixir/Phoenix/LiveView — 26 specialist agents, Iron Laws enforcement, and Tidewave MCP integration. Plan features with parallel research agents, execute with automatic verification, review with 4-agent parallel audits, and capture learnings as reusable knowledge.”
A slash command is a reusable prompt saved as a markdown file and run by typing its name after a slash. In Claude Code, custom commands have been merged into skills: a file in .claude/commands/ and a skill folder in .claude/skills/ both create the same kind of command, and existing command files keep working.
Techdebt gives you a repeatable way to run the same instructions without retyping them, optionally with arguments.
How to install Techdebt
Claude Code
- Download techdebt.md from the repository.
- Save it to ~/.claude/commands/ (all projects) or .claude/commands/ (one project). As a skill, you can instead save it as ~/.claude/skills/<name>/SKILL.md.
- Run it by typing / followed by its name.
Claude Cowork
- Turn the command into a skill: create a folder with the file saved as SKILL.md and zip it.
- In Customize → Skills, click +, then upload the ZIP.
- Run it from any task with / and the skill name.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from .claude/commands/techdebt.md, shared under the repository's MIT license. Read the full file on GitHub.
Scan the codebase for common Elixir/Phoenix tech debt patterns.
Check for
- Dead code: Unused functions, modules, aliases
- mix xref unreachable
- Grep for # TODO, # FIXME, # HACK
- Duplicated code: Similar function bodies across modules
- Missing typespecs: Public functions without @spec
- Large modules: Files > 300 lines
- Missing tests: Modules in lib/ without corresponding test/ files
- Deprecated patterns: Old Phoenix/Ecto patterns
- Credo issues: mix credo --strict --format json
Output format
Priority-sorted list with file:line references and suggested fixes.
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Techdebt?
Techdebt is a slash command for Claude Code and Claude Cowork from the oliver-kriska/claude-elixir-phoenix repository on GitHub. Find and report technical debt in the codebase
How do I install Techdebt in Claude Code?
Download techdebt.md from the repository. Save it to ~/.claude/commands/ (all projects) or .claude/commands/ (one project). As a skill, you can instead save it as ~/.claude/skills/<name>/SKILL.md. Run it by typing / followed by its name.
Can I use Techdebt in Claude Cowork?
Turn the command into a skill: create a folder with the file saved as SKILL.md and zip it. In Customize → Skills, click +, then upload the ZIP. Run it from any task with / and the skill name.
Is Techdebt safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Phx Elixir/Phoenix/LiveView development with specialist agents, Iron Laws, and Tidewave MCP integration Plugin · oliver-kriska/claude-elixir-phoenix
- Hex Deps Triager Triage Hex supply-chain audit findings in Elixir/Phoenix — review diff windows and metadata to produce structured security verdicts. Use after /phx:deps-audit. Subagent · oliver-kriska/claude-elixir-phoenix
- Elixir Reviewer Expert Elixir/Phoenix code reviewer - idioms, patterns, performance, conventions. Use proactively after writing Elixir code. Subagent · oliver-kriska/claude-elixir-phoenix
- Hex Library Researcher Researches Elixir libraries on hex.pm. Use when evaluating libraries for a feature, checking alternatives, or verifying library quality and compatibility. Subagent · oliver-kriska/claude-elixir-phoenix
- OCR: Address Feedback Address code review feedback — corroborate, validate, and implement changes from a review's final.md. Slash Command · spencermarx/open-code-review
- Psql Query Run ad-hoc PostgreSQL analytics queries against dev/test database Slash Command · oliver-kriska/claude-elixir-phoenix
- OCR: Create Reviewer Create a new custom reviewer from a natural language description. Slash Command · spencermarx/open-code-review
- Spec Load Load specs and lessons for current context Slash Command · catlog22/maestro-flow