Habilidades project-operator
🔧

project-operator

Seguro 🌐 Acceso a red📁 Acceso al sistema de archivos

Operate and debug local stack

Debugging distributed local stacks can be chaotic with unclear error sources and risky restarts. This skill provides structured observability practices, log-focused debugging, and safe automation patterns for API, worker, and frontend components.

Soporta: Claude Codex Code(CC)
📊 69 Adecuado
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Pruébalo

Usando "project-operator". Check the health of all my local services

Resultado esperado:

  • API service: Running (healthy)
  • Worker service: Running (healthy)
  • Frontend service: Error - Connection refused on port 3000
  • Recommendation: Check frontend logs for startup errors

Usando "project-operator". Tail the logs and look for error patterns

Resultado esperado:

  • API logs: 3 connection timeout errors in the last 5 minutes
  • Worker logs: No errors, processing normally
  • Frontend logs: Warning - deprecated API endpoint called
  • Most common issue: Database connection timeouts

Usando "project-operator". How do I safely update my configuration?

Resultado esperado:

  • Proposed change: Increase worker concurrency from 4 to 8
  • Impact: Higher throughput but increased memory usage (~200MB additional)
  • Revert strategy: Set WORKER_CONCURRENCY back to 4 in .env file
  • Recommended: Test with one worker first before full deployment

Auditoría de seguridad

Seguro
v5 • 1/16/2026

This is a prompt-only documentation skill with no executable code. The SKILL.md provides operational guidance for debugging local development environments. The static analysis findings are false positives triggered by SHA256 hashes and version strings being misidentified as cryptographic patterns. No network calls, filesystem access, or external commands exist.

2
Archivos escaneados
189
Líneas analizadas
2
hallazgos
5
Auditorías totales

Factores de riesgo

🌐 Acceso a red (1)
skill-report.json:6
📁 Acceso al sistema de archivos (1)
skill-report.json:6
Auditado por: claude Ver historial de auditorías →

Puntuación de calidad

38
Arquitectura
100
Mantenibilidad
87
Contenido
20
Comunidad
100
Seguridad
91
Cumplimiento de la especificación

Lo que puedes crear

Debug distributed systems

Trace errors across API, worker, and frontend layers using structured log analysis and health checks.

Monitor local services

Check service status, tail logs, and apply changes safely with clear rollback procedures.

Reproduce and isolate issues

Follow incremental debugging steps and use observability tools to isolate root causes.

Prueba estos prompts

Check service health 
Check the health of all services in my local stack. Identify any that are down or showing errors. Report status for each component.
Tail and analyze logs 
Tail the logs for my local stack. Look for error patterns and identify the most recent issues across all services.
Safe configuration change 
I need to update my configuration. Explain the impact of the change and provide a revert path in case something goes wrong.
Debug long-running operation 
I started a long-running command and it seems stuck. Check the status and provide a strategy to stop or cancel it safely.

Mejores prácticas

  • Read logs before restarting any service to understand the root cause
  • Make incremental changes so each change is observable and can be reverted
  • Always ask for a revert strategy before applying configuration changes

Evitar

  • Restarting services without first reading logs or checking error messages
  • Making large, sweeping changes without a rollback plan
  • Running long commands without knowing how to stop them

Preguntas frecuentes

Does this skill restart services automatically?
No. The skill focuses on observability and safe automation patterns. It will advise on restart strategies but never execute them without explicit instruction.
Can I use this with production environments?
This skill is designed for local development stacks. Production debugging requires different safety protocols and access controls.
What stack components are supported?
The skill works with API, worker, and frontend components. It focuses on reading logs, checking status, and providing guidance.
Is my data safe when using this skill?
Yes. This is a prompt-only skill. It reads logs and status information from your local stack but does not transmit data externally.
Why are my services not starting?
Check the logs first. Common issues include port conflicts, missing environment variables, or configuration errors. The skill can help analyze logs.
How is this different from general debugging tools?
This skill provides structured debugging workflows specifically for distributed local stacks with emphasis on safe, observable changes.

Detalles del desarrollador

Licencia

MIT

Repositorio

https://github.com/ACSKamloops/shs-engine/tree/master/.codex/skills/project-operator

Ref.

master

Estructura de archivos

📄 SKILL.md