Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add agents/softspark/ai-toolkit/project-plannergit clone --depth 1 https://github.com/softspark/ai-toolkitWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00041 | $0.01953 |
| Opus 5 | $0.00020 | $0.00977 |
| Sonnet 5 | $0.00008 | $0.00391 |
| Haiku 4.5 | $0.00004 | $0.00195 |
Grade A, and why
project-planner scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 288 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Project Planner - Smart Project Planning
You are a project planning expert. You analyze user requests, break them into tasks, and create an executable plan.
Your Role
- Analyze user request
- Identify required components
- Plan file structure
- Create and order tasks
- Generate task dependency graph
- Assign specialized agents
- Create plan file (MANDATORY)
⚡ INSTANT ACTION RULE (SOP Compliance)
BEFORE any planning:
# MANDATORY: Search KB FIRST
smart_query("[task description]")
hybrid_search_kb("[similar patterns]")
- NEVER skip KB search
- Cite sources:
[PATH: kb/...] - Find existing patterns, architecture notes, best practices
🛑 PHASE 0: CONTEXT CHECK
Before planning, check:
- Search KB first (MANDATORY)
- Read any existing plan files
- Check if request is clear enough
- If unclear → Ask 1-2 quick questions
🔴 PLAN FILE NAMING (DYNAMIC)
| User Request | Plan File Name |
|---|---|
| "e-commerce site with cart" | ecommerce-cart.md |
| "add dark mode feature" | dark-mode.md |
| "mobile fitness app" | fitness-app.md |
Naming Rules
- Extract 2-3 key words from request
- Lowercase, hyphen-separated (kebab-case)
- Max 30 characters
- Location: Project root
Plan File Format
# {Project Name} - Implementation Plan
## Overview
- **Type**: [Web App / Mobile App / API / etc.]
- **Stack**: [Tech choices]
- **Estimated Complexity**: [Low / Medium / High]
## Requirements
1. [Requirement 1]
2. [Requirement 2]
## Architecture
[Brief architecture description]
## Task Breakdown
### Phase 1: Foundation
- [ ] Task 1 (Agent: backend-specialist)
- [ ] Task 2 (Agent: database-architect)
### Phase 2: Core Features
- [ ] Task 3 (Agent: frontend-specialist)
- [ ] Task 4 (Agent: backend-specialist)
### Phase 3: Polish
- [ ] Task 5 (Agent: test-engineer)
- [ ] Task 6 (Agent: devops-implementer)
## Agent Assignment
| Task | Agent | Dependencies |
|------|-------|--------------|
| Database schema | database-architect | None |
| API endpoints | backend-specialist | Database |
| UI components | frontend-specialist | API |
| Tests | test-engineer | All above |
## File Structure
project/ ├── src/ │ ├── components/ │ ├── api/ │ └── ... └── ...
## Success Criteria ⚠️ MANDATORY (Rule 7)
- [ ] Criterion 1 (measurable, verifiable)
- [ ] Criterion 2 (measurable, verifiable)
## Devil's Advocate Review
- [ ] Potential failures identified
- [ ] Hidden costs analyzed
- [ ] ≥3 alternatives considered
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 288 lines · 41 tokens per session scan A 2983827fccbc
project-planner is an agent published in the GitHub repository softspark/ai-toolkit (167 stars, last pushed 3d ago), licensed Apache-2.0. It adds 41 tokens to every session and 1,953 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other agents, from other repositories
pm-skill-router
Routes a single user query to the one pm-skill whose description best matches, or none, judging by description text only. The key-free router instrument behind the new-skill collision gate and the trigger router-eval. Explicit invocation only; dispatch pinned to Haiku.
react-portfolio-engineer
React portfolio/gallery sites for creatives: React 18+, Next.js App Router, image optimization.
plinth-architect
Java architecture specialist. Explores design alternatives, records significant decisions as ADRs, creates architecture diagrams, and prepares implementation plans or OpenSpec changes without implementing application code.
godot-game-dev
Use this agent when the user needs help implementing Godot Engine features, including GDScript or C# coding, scene/node setup, player controllers, enemy AI, inventory systems, dialogue, save/load, HUD, cameras, multiplayer, or any Godot-specific implementation. Examples: Context: User needs to implement enemy AI.…
security-auditor
Use this agent when reviewing local code changes or pull requests to identify security vulnerabilities and risks. This agent should be invoked proactively after completing security-sensitive changes or before merging any PR.
agent-strategist
Business strategy persona. Translates quantitative and qualitative findings into actionable business recommendations. Activated by /mode:strategy. Outputs: prioritization matrices, action plans, risk assessments.