Speq code tools

Skill marconae/speq-skill/.claude/skills/speq-code-tools

Semantic code navigation and editing via Serena MCP — symbol-level tools preferred over grep/find/manual edits. Triggered by /speq-mission, /speq-implement, planner-agent, implementer-agent, implementer-expert-agent, code-reviewer, and recorder-agent.From its SKILL.md

Install

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

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

1.6 KB, 317 tokens by cl100k_base, as published. Nobody here has run it

Code Tools

Semantic code navigation and editing via Serena MCP.

Tool Preference

Task	Use	Not
List directory	`list_dir`	`ls`, `find`
Find files	`find_file`	`find`, `rg --files`
File symbols	`get_symbols_overview`	`rg "class\|function"`
Symbol definition	`find_symbol`	`rg "function foo"`
Symbol references	`find_referencing_symbols`	`rg "foo("`
Update function	`replace_symbol_body`	read/edit/write
Insert after	`insert_after_symbol`	read/edit/write
Insert before	`insert_before_symbol`	read/edit/write
Rename symbol	`rename_symbol`	`rg` + manual edits

Reflection Checkpoints

Apply the Feynman Technique — explain your understanding before proceeding. Call these tools at key moments:

Tool	When
`think_about_collected_information`	After exploration sequence
`think_about_task_adherence`	Before writing code
`think_about_whether_you_are_done`	Before reporting completion

Workflow

Explore → find_symbol, get_symbols_overview
Understand → find_referencing_symbols
Reflect → think_about_collected_information
Edit → replace_symbol_body, insert_*_symbol
Verify → find_referencing_symbols
Complete → think_about_whether_you_are_done

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.