Our review
Spawns subagents with configurable tool access to process large data (git history, logs) and return concise answers without flooding the context.
Strengths
- Parallel execution of multiple subagents to handle simultaneous tasks.
- Fine-grained tool restriction to prevent unnecessary actions and preserve context.
- Efficient for analyzing large repositories or logs without context pollution.
Limitations
- Requires the `synu` shell plugin and `claude` CLI tool, limiting portability.
- Relies on precise tool configuration; incorrect settings may yield incomplete results.
- Prompts must be thorough and specific to be useful, requiring careful thought.
When processing large datasets (git history, diffs, logs) or performing parallel analyses across multiple repositories.
For simple tasks or when subagent doesn't require specific tool restrictions, as the setup overhead outweighs benefits.
Security analysis
CautionThe skill describes spawning subagents via shell commands, which is a powerful capability. While the example restricts tools tightly, the skill itself does not enforce restrictions; it relies on the user to specify safe configurations. This could lead to unintended command execution if misused.
- •Uses shell commands (synu claude) to spawn subagents with potentially arbitrary tool access; improper restriction could lead to execution of unintended operations.
- •Relies on external CLI tools (synu, claude) which may not be present or configured securely.
Examples
cd /path/to/other/repo && synu claude --disallowed-tools 'Bash(*) Explore Edit Read WebFetch WebSearch Glob Grep NotebookEdit NotebookRead SlashCommand Write' --allowed-tools 'Bash(git log:*) Bash(git show:*)' -p 'Using only git log and git show, summarise the major user-facing changes in abc123..def456. Do not provide code snippets or technical details. Consider user-facing changes, like being able to set a port-out PIN or adding a new button or changing font sizes.'synu claude --allowed-tools 'Read' -p 'Analyze the README.md files of /path/to/repoA and /path/to/repoB. List the main features of each and compare them.'synu claude --disallowed-tools 'Edit Write Explore' --allowed-tools 'Bash(grep:*) Bash(cat:*) Bash(awk:*)' -p 'Analyze /var/log/app.log for errors. Using grep and awk, count each unique error type and list the top 5 most frequent errors with their count and first occurrence timestamp.'name: invoking-subagents
description: Spawns subagents with configurable tool access that return just the answers without flooding your context. Use for summarizing extensive git history, comparing across multiple repositories in parallel, or processing large diffs/logs.
compatibility: Requires synu shell plugin and claude CLI tool
license: AGPL-3.0-or-later
metadata:
author: Amolith amolith@secluded.site
Invoke with synu claude --flags -p 'prompt'.
Important: Subagents are scoped to their cwd, just like you. To work in another repository, cd there first.
Use a precise and thorough prompt. Aggressively restrict which tools it can interact with; if it doesn't need Edit, don't give it Edit. If it needs to read files, Glob, Grep, and Read are probably sufficient. Task can be helpful. Notebook, Slash, Write, Web, Edit, etc. should almost never be necessary. Execute them in the background. You may invoke multiple when appropriate and in parallel if helpful. Once they're running, you may either stop and wait for me to tell you they're finished or continue with other work.
Example exploring git history in another repo:
cd /path/to/other/repo && fish -c "synu claude --disallowed-tools 'Bash(*) Explore Edit Read WebFetch WebSearch Glob Grep NotebookEdit NotebookRead SlashCommand Write' --allowed-tools 'Bash(git log:*) Bash(git show:*)' -p 'Using only git log and git show, summarise the major user-facing changes in HASH..HASH. Do not provide code snippets or technical details. Consider user-facing changes, like being able to set a port-out PIN or adding a new button or changing font sizes.'"
Refer to installing-synu.md if it's unavailable.
Next.js App Router Expert
Development
A skill that turns Claude into a Next.js App Router expert.
README Generator
Development
Creates professional and comprehensive README.md files for your projects.
API Documentation Writer
Development
Generates comprehensive API documentation in OpenAPI/Swagger format.