skills.rest
grandamenium
grandameniumCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

agent-management

Manage cortextOS agent lifecycle actions via the cortextOS CLI.

88|108|Updated Apr 7, 2026
Search Tags:#environment variables#agent management#model configuration#pm2#crash recovery#telegram bot#restarts
One-click install
npx skills add https://github.com/grandamenium/cortextos --skill agent-management-grandamenium
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-management
Source: https://github.com/grandamenium/cortextos/tree/main/templates/analyst/.claude/skills/agent-management
Command: npx skills add https://github.com/grandamenium/cortextos --skill agent-management-grandamenium

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It resolves the day-to-day pain of keeping cortextOS agents running correctly—covering creation, restarts, model changes, Telegram credentials, enable/disable, health checks, and crash recovery—without breaking orchestration rules.

Core Features & Use Cases

  • Agent lifecycle operations: Create, enable, disable, list, spawn for another user, and manage PM2 process behavior using the supported CLI commands.
  • Restart control with correct semantics: Perform soft restarts to preserve conversation state or hard restarts when hooks/settings must be reloaded.
  • Credential and configuration safety: Generate per-agent .env with correct BOT_TOKEN, CHAT_ID, and ALLOWED_USER, and avoid token/chat-id mistakes that route messages to the wrong person.
  • Operational troubleshooting: Diagnose “agent not responding,” recurring crashes, and PM2 restart issues with the correct verification steps and recovery actions.

Quick Start

Tell the agent what you want to do, for example: "Create a new Analyst agent for my org using Claude Code, then enable it and ensure its Telegram bot token and chat ID are correctly set."

Frequently Asked Questions about agent-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely restart an agent and reload hooks without losing conversation state?▼

Perform a soft restart to preserve conversation state, or use a hard restart when hooks and settings must be completely reloaded. Use the correct CLI command to select the appropriate restart behavior.

Why does my Telegram bot send agent responses to the wrong chat?▼

Telegram bot messages route to the wrong person when the BOT_TOKEN or CHAT_ID in the per-agent .env file are incorrect. Generate isolated .env files with correct credentials to fix this.

How do I diagnose an agent that is not responding or keeps crashing?▼

Diagnose non-responsive or crashing agents by checking PM2 process behavior and running the correct verification steps. Use CLI commands to manage restarts and apply crash recovery actions.

Can I spawn and manage an agent for another user in cortextOS?▼

Yes, you can spawn agents for another user through supported lifecycle operations. Use the cortextOS CLI to coordinate cross-user spawns while maintaining per-agent .env isolation.

What is the correct way to change the model configuration for a running agent?▼

Change model configuration by applying the supported CLI commands for agent lifecycle operations. This ensures the running agent updates safely without breaking orchestration rules.

Do I need to use the cortextOS CLI for all agent state changes?▼

Yes, you must use the cortextOS CLI for all state-affecting changes to agents. This ensures correct enable/disable actions, restart modes, and credential updates without breaking orchestration.

Related Skills

Explore More Software Engineering Skills→
grandameniumgrandamenium
88

env-management

Resolve missing or stale environment variables and secret keys for cortextOS agents.

Community
Advanced
JuelHossainJuelHossain

resilience

Enforce persistence and crash recovery for Kalshi trading engine cycles.

Community
Advanced
terrylicaterrylica
62

telegram-bot-management

Manage claude-orchestrator Telegram bot lifecycle with launchd and watchexec.

Community
Advanced
urjitbhatiaurjitbhatia
2

brainlog-guide

Monitor, search, and manage terminal processes via the Brainlog MCP server.

Community
Intermediate