simple_mind

Submit a bug report to libraries within the `mngr` project (eg, `mngr`, its plugins, `minds`, etc). Use to report bugs you encounter while running that seem to be issues with the `mngr` code itself, rather than with your own code or configuration.

Run commands to explore the current state of mngr and any relevant running agents. Use this skill when you need to debug issues with mngr tasks, or understand what tasks are currently running and their states.

Handle events from the mngr/agent_states source about sub-agent state transitions (finished, waiting, done, etc). You **MUST** use this skill (and *carefully follow the process in this doc*) whenever you receive a message from the "mngr/agent_states" source!

Clean up old agents, their output directories, and other historical data. Use during nightly cleanup or when the system has accumulated stale data.

Handle unexpected situations where the Minds system does not appear to be working as expected. Use when you encounter behavior that seems to contradict what your docs and prompts and skills say should happen, or when something seems broken and you are unsure how to proceed.

Create a sub-agent to perform a task. Use when you need to delegate work to another agent, for example, a working agent (for actually accomplishing some task) or a verifying agent (for deciding what to do about the output of a working agent).

Handle events from the messages source about user or assistant messages in conversations. You **MUST** use this skill (and *carefully follow the process in this doc*) whenever you receive a message from the "messages" source!

Handle "idle" events for periodic housekeeping and proactive work. You **MUST** use this skill (and *carefully follow the process in this doc*) whenever you receive a message from the "mind/idle" source!

Act on the results of a verifying agent by reviewing its recommendations and taking the appropriate next actions. You **MUST** use this skill (and *carefully follow the process in this doc*) whenever a verifying agent finishes!

List all active conversations for this mind. Use when you need to see what conversations exist, check their models, or find a conversation ID.

List all event sources and types you may receive, with descriptions of their fields and meaning. Note that event types are dynamic and new sources may appear.

Mark events as handled after processing them. You **MUST** use this skill (and *carefully follow the process in this doc*) after handling events, otherwise you will not be allowed to stop!

Search through past events in the event log files. Use when you need to look up something that happened previously but didn't store in memory.

Send a message to the user in a conversation. You MUST use this skill to reply in an existing conversation, start a new conversation, or proactively reach out.

Forward new information to a running agent, or adjust a task based on changed requirements. Use when the user provides additional context, clarifications, or changed requirements for an in-flight task.

Create a verifying agent to check whether a working agent's task was completed successfully. Use after a working agent finishes (transitions to "done", "stopped", "waiting", or "paused") and appears to believe its task is complete.

Check for pending tickets that are ready to be worked on. Use when capacity opens up (e.g., after an agent finishes) to find the next highest-priority work to delegate.

Handle the one-time first-run event to set up onboarding tickets and introduce yourself to the user. You **MUST** use this skill (and *carefully follow the process in this doc*) whenever you receive a message from the "mind/onboarding" source!

Pull in updates from the parent branch to improve this Mind's skills, prompts, and configuration. Use only when prompted by the user.

Create a ticket to track work that needs to be done. Use when you need to record some work or action that needs to be done later (e.g., when at capacity), track a multi-step project, or log follow-up work from a completed ticket.

Handle events from unknown or unexpected sources, including warnings and errors. You **MUST** use this skill (and *carefully follow the process in this doc*) whenever you receive a message from a source that does not have a more specific handler skill!

Handle regularly scheduled time-of-day events (start_of_day, end_of_day, etc). You **MUST** use this skill (and *carefully follow the process in this doc*) whenever you receive a message from the "mind/schedule" source!

Create a new skill to handle a previously-unknown type of event (eg, from an unknown source). Use in order to generate the appropriate skill for the user, and ensure that such messages will be received (by removing the source name from the "ignored_sources.txt" file if it is there).