← Back to Skills Marketplace
kirkraman

agent-task-manager

by KirkRaman · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
102
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install kirk-agent-task-manager
Description
Manages multi-step, stateful agent workflows with task dependencies, persistent state, error recovery, and external API rate-limit handling using SkillBoss A...
README (SKILL.md)

name: agent-task-manager name: agent-task-manager description: Manages and orchestrates multi-step, stateful agent workflows; handles task dependencies, persistent state, error recovery, and external rate-limiting. Use for creating new multi-agent systems, improving sequential workflows, or managing time-bound actions. requires.env: [SKILLBOSS_API_KEY]

Agent Task Manager

Overview

This skill provides the structure and primitives for building resilient, complex, and professional multi-agent systems powered by the SkillBoss API Hub. It transforms simple scripts into production-ready workflows, with AI capabilities (LLM reasoning, notification delivery) routed through a single unified endpoint.

Core Capabilities

1. Orchestration and Task State

  • Capability: Defines tasks with clear inputs, outputs, and dependencies (DAG-like structure).
  • Execution: Uses molt_task.py to manage state in task_state.json.
  • Value: Prevents redundant work, allows agents to resume mid-workflow after a session reset.

2. External Rate-Limit Management

  • Capability: Manages the cooldown and retry logic for externally rate-limited actions (e.g., API posts, web scrapes).
  • Execution: Uses the scripts/cooldown.sh wrapper to store last-executed timestamps and automatically wait/retry.
  • Value: Ensures continuous operation without violating API rate limits.

3. Modular Role-Based Agents

  • Capability: Provides a template structure for specialized roles (e.g., ContractAuditor, FinancialAnalyst).
  • Execution: Modules are designed to be run independently or sequenced by the Orchestrator. AI reasoning steps call the SkillBoss API Hub (/v1/pilot) for LLM inference and notification delivery.
  • Value: Enables the creation of focused, expert agents for complex tasks like the MoltFinance-Auditor.

Example Workflow: MoltFinance-Auditor

  1. Task: FinancialAudit
  2. Dependencies:
    • Role 1: ContractAuditor (Input: Contract Address, Output: Contract Safety Score)
    • Role 2: FinancialAnalyst (Input: Contract Address + Safety Score, Output: Trust Score via SkillBoss API Hub LLM)
  3. External Action: NotificationAgent (Dependent on final Trust Score; delivers alert via SkillBoss API Hub email/SMS; subject to Rate Limit).

API Integration

All AI inference and notification delivery is handled through SkillBoss API Hub:

  • Endpoint: https://api.skillboss.co/v1/pilot
  • Auth: Authorization: Bearer $SKILLBOSS_API_KEY
  • LLM response path: data.result.choices[0].message.content

Resources

scripts/

  • molt_task.py: Python class for task state management.
  • orchestrator.py: Workflow execution engine; calls SkillBoss API Hub for AI role execution.
  • task_parser.py: Converts natural language requests to task structures; uses SkillBoss API Hub LLM as fallback parser.
  • cooldown.sh: Shell wrapper for managing rate-limited executions.

references/

  • task_schema.md: JSON schema for defining complex task dependencies.
Usage Guidance
This skill appears to implement the advertised orchestration and SkillBoss integration, but there are important inconsistencies to address before installing: - The code and SKILL.md require SKILLBOSS_API_KEY (os.environ["SKILLBOSS_API_KEY"]) but the registry metadata lists no required env vars. Expect to provide a SkillBoss API key; otherwise the scripts will error. - The Python scripts use the requests library but the skill does not declare dependencies. Ensure your environment has Python 3 and the required packages installed (e.g., pip install requests) before running. - The skill will send parsed human requests, workflow definitions, and any task data to api.skillboss.co. Do not provide sensitive secrets or private data in tasks unless you trust SkillBoss and understand the API key's permissions and retention policy. - The skill writes task_state.json and ./agent_task_manager_data/*. If you run it in a shared environment, consider running in an isolated directory or container to avoid leaking task content. - Source and homepage are unknown. If you need higher assurance, request or verify the publisher identity, check for signed releases, or review the included code yourself. If you cannot verify provenance, run in a sandbox and limit the SKILLBOSS_API_KEY scope (rotate/delete the key after testing). Given these mismatches (undeclared env var and undeclared dependency), treat the skill as suspicious until the author or registry metadata is corrected and you confirm the runtime behavior in a safe environment.
Capability Analysis
Type: OpenClaw Skill Name: kirk-agent-task-manager Version: 1.0.2 The skill contains a shell injection vulnerability in `scripts/cooldown.sh` due to the use of `eval` on unsanitized command-line arguments. It also relies heavily on an external third-party API (`api.skillboss.co`) for core LLM reasoning, task parsing, and notification delivery (email/SMS), which involves sending task-related data and the `SKILLBOSS_API_KEY` to an external endpoint. While the functionality aligns with the stated purpose of managing multi-agent workflows and financial monitoring, the combination of high-risk execution patterns and external dependencies warrants caution.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
The skill's code and SKILL.md consistently call https://api.skillboss.co/v1/pilot using an environment variable SKILLBOSS_API_KEY, which is coherent with the stated purpose (SkillBoss-backed orchestration). However, the registry metadata lists no required env vars or dependencies; that's inconsistent and misleading (the skill will fail or raise KeyError without SKILLBOSS_API_KEY).
Instruction Scope
SKILL.md and the Python scripts instruct the agent to call the SkillBoss API for parsing, LLM inference, and notifications, and to read/write local state files (task_state.json, agent_task_manager_data/*). That scope matches the description, but the instructions access an environment secret (SKILLBOSS_API_KEY) that the registry did not declare — the instructions therefore reference runtime secrets not advertised in metadata.
Install Mechanism
No install spec (instruction-only install). All code is included in the skill bundle; no external downloads or extract steps are specified. This is low-install-risk, but it does mean the included Python scripts will run as-is in the agent environment.
Credentials
The only credential used is SKILLBOSS_API_KEY (appropriate for the SkillBoss integration). However: (1) the registry metadata did not declare this required env var, (2) the code will transmit task contents and any parsed user inputs to SkillBoss, which may include sensitive data, and (3) Python dependency 'requests' is used but not declared in metadata. These omissions reduce transparency and raise the chance of accidental secret exposure or runtime failure.
Persistence & Privilege
The skill persists state locally (task_state.json) and creates a timestamp directory ./agent_task_manager_data for cooldowns. It does not request always:true or system-wide config changes and does not modify other skills. This local persistence is proportional to its purpose but operators should be aware that files are created in the working directory and may contain task data.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install kirk-agent-task-manager
  3. After installation, invoke the skill by name or use /kirk-agent-task-manager
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Updated SkillBoss API Hub endpoint from api.heybossai.com to api.skillboss.co in documentation and scripts. - Improved documentation in SKILL.md for accuracy and consistency with API usage. - Minor refinements in orchestrator.py and task_parser.py to align with new API endpoint.
v1.0.0
- Initial release of Agent Task Manager skill. - Provides orchestration and state management for multi-step agent workflows, supporting DAG-like task dependencies and resilient recovery. - Integrated management of external rate-limits with automatic cooldowns and retries. - Modular agent structure with templates for specialized roles (such as ContractAuditor, FinancialAnalyst). - Centralized AI reasoning and notification delivery routed via the SkillBoss API Hub. - Includes scripts for task state tracking, workflow orchestration, task parsing, and rate-limit handling.
Metadata
Slug kirk-agent-task-manager
Version 1.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is agent-task-manager?

Manages multi-step, stateful agent workflows with task dependencies, persistent state, error recovery, and external API rate-limit handling using SkillBoss A... It is an AI Agent Skill for Claude Code / OpenClaw, with 102 downloads so far.

How do I install agent-task-manager?

Run "/install kirk-agent-task-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is agent-task-manager free?

Yes, agent-task-manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does agent-task-manager support?

agent-task-manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created agent-task-manager?

It is built and maintained by KirkRaman (@kirkraman); the current version is v1.0.2.

💬 Comments