Notre avis
Cette compétence guide la recherche et la planification d'une nouvelle fonctionnalité ou d'un nouveau skill pour un système d'agents, en formalisant un plan structuré avant toute implémentation.
Points forts
- Structure claire en phases (recherche puis rédaction du plan)
- Évite le développement non planifié en imposant une étape de recherche
- Produit un document de plan réutilisable et traçable
- Couvre à la fois les aspects techniques et les dépendances (vault, configuration)
Limites
- Nécessite que le système cible dispose de l'infrastructure décrite (scouts, plans, serveur MCP)
- Ne fournit pas de modèle pour des modifications simples ou ponctuelles
- La phase de recherche dépend de la disponibilité des services existants
Utilisez cette compétence lorsque vous devez ajouter un nouveau skill, un outil MCP, un endpoint API ou un composant Vue, et que vous voulez vous assurer que toutes les implications sont documentées avant de coder.
Ne l'utilisez pas pour des modifications mineures (correction de bugs, refactoring simple) ou lorsque le système cible ne suit pas l'architecture MCP décrite.
Analyse de sécurité
SûrThe skill instructs the agent to research existing skills and service state and write a plan file, without any destructive or exfiltrating actions. No code execution or dangerous commands are explicitly instructed; it's a planning aid.
Aucun point d'attention détecté
Exemples
Plan a new skill for AWS EC2 instance management. The skill should list instances and allow starting/stopping them. Research existing AWS skills and the live AWS API state.Plan a new MCP tool that pings all services in the service_catalog and returns their status. Include research on current service catalog and API endpoints.Plan a new API endpoint GET /api/logs that returns agent execution logs. Research existing API structure and authentication requirements.description: Research and plan a new skill or agent feature before implementing argument-hint: <describe the skill or feature>
Phase 1 — Research (spawn scouts)
skill-scout: Check existing skills
- Are there existing skills for this service? What patterns do they use?
- What's in SKILL_META for similar skills (compat section especially)?
- What does _template.py require?
service-scout: Check live service state
- Is the target service running and reachable?
- What version is it? What API endpoint can be probed for live_validator?
- Does it appear in the service_catalog?
Phase 2 — Write the plan
Write to state/plans/PLAN-$ARGUMENTS.md:
# Plan: $ARGUMENTS
Date: <timestamp>
Status: pending
## Current state
<skill-scout summary>
<service-scout summary>
## What to build
Type: [ ] new skill module | [ ] new MCP tool | [ ] new API endpoint | [ ] new Vue component
### If new skill module:
File: mcp_server/tools/skills/modules/<service>_<action>.py
SKILL_META draft:
- name: <service>_<action>
- description: <one line>
- category: compute | networking | monitoring | storage | orchestration
- parameters: <dict>
- compat:
- service: <name>
- api_version_built_for: <version>
- version_endpoint: <endpoint to probe>
- version_field: <jq path to version in response>
execute() outline:
1. Read config from env/agent_settings.json
2. <core API call>
3. Return _ok/_err/_degraded
### If new MCP tool (register in server.py):
Function name: <verb_noun>
Parameters: <list>
Calls into: mcp_server/tools/<module>.py
### If API/GUI change:
Router: api/routers/<name>.py
Endpoint: <METHOD> /api/<path>
Auth required: yes/no
## Implementation steps
1. [ ] Write the module (sync, no async, _ok/_err/_degraded returns)
2. [ ] `python -m py_compile <file>` — syntax check
3. [ ] Register in server.py if MCP tool
4. [ ] Add UFW rule in hp1-infra if new port exposed
5. [ ] Test: call via API or agent commands panel
6. [ ] `/commit`
## Vault / config changes needed
<list any new env vars or vault keys needed — human sets these>
## Out of scope
<what this plan does NOT cover>
Do NOT write any code yet. Plan only.
Expert Next.js App Router
Developpement
Un skill qui transforme Claude en expert Next.js App Router.
Générateur de README
Developpement
Crée des README.md professionnels et complets pour vos projets.
Rédacteur de Documentation API
Developpement
Génère de la documentation API complète au format OpenAPI/Swagger.