Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

speq-code-tools

Semantic code navigation and editing via Serena MCP — symbol-level tools required over grep/find/manual edits. Triggered by planner-agent, implementer-agent, implementer-expert-agent, code-reviewer, and recorder-agent.

marconae · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add marconae/speq-skill --skill speq-code-tools

About this skill


name: speq-code-tools description: Semantic code navigation and editing via Serena MCP — symbol-level tools required over grep/find/manual edits. Triggered by planner-agent, implementer-agent, implementer-expert-agent, code-reviewer, and recorder-agent.

Code Tools

Semantic code navigation and editing via Serena MCP. Tools are called mcp__plugin_speq_serena__<name> (e.g. mcp__plugin_speq_serena__find_symbol); this skill refers to them by short name below.

Before First Use Each Session

  1. Call initial_instructions first, before any other Serena tool.
  2. These tools are deferred in this harness — a bare tool name has no loaded schema yet. Call ToolSearch with select:mcp__plugin_speq_serena__<name> (comma-separated for several) to load the ones you need before calling them.

Tool Preference

You MUST use these instead of the generic alternative — do not fall back to Read/Grep/Edit/ls/find for anything this table covers.

TaskUseNot
List directorylist_dirls, find
Find filesfind_filefind, rg --files
File symbolsget_symbols_overviewrg "class|function"
Symbol definitionfind_symbolrg "function foo"
Symbol declarationfind_declarationrg guesswork
Symbol referencesfind_referencing_symbolsrg "foo("
Interface/method implementationsfind_implementationsrg "impl .* for"
LSP diagnostics for a fileget_diagnostics_for_filemanual build/check
Update functionreplace_symbol_bodyread/edit/write
Insert afterinsert_after_symbolread/edit/write
Insert beforeinsert_before_symbolread/edit/write
Rename symbolrename_symbolrg + manual edits
Delete symbolsafe_delete_symbolmanual delete + grep for refs
In-file text/regex replacereplace_contentread/edit/write
Multi-file pattern replacereplace_in_filesmultiple manual edits

Memory tools (write_memory, read_memory, list_memories, delete_memory, edit_memory, rename_memory) exist and are available, but this project's specs (specs/, specs/_plans/.../notes/) are the source of truth — they are not part of this workflow.

Workflow

Session start → initial_instructions
Explore → find_symbol, get_symbols_overview, find_declaration
Understand → find_referencing_symbols, find_implementations
Edit → replace_symbol_body, insert_*_symbol, replace_content, replace_in_files
Verify → find_referencing_symbols, get_diagnostics_for_file