tools-script-executor

Execute marketplace scripts through a centralized Python proxy with notation-based invocation.

4|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/cuioss/plan-marshall --skill tools-script-executor
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: tools-script-executor
Source: https://github.com/cuioss/plan-marshall/tree/main/marketplace/bundles/plan-marshall/skills/tools-script-executor
Command: npx skills add https://github.com/cuioss/plan-marshall --skill tools-script-executor

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes scripts (resource) components.

What problem does it solve?

All marketplace scripts are executed through .plan/execute-script.py which provides a single entry point, standardized environment, and consistent error handling.

Core Features & Use Cases

  • Centralized script execution via a Python proxy with deterministic behavior
  • Notation-based invocation supports plan-aware workflows (e.g., plan-marshall:...) and cross-bundle scripts
  • Integrated logging: plan-scoped and global logs, with trace-plan-id support for per-plan auditing
  • Extensible via scripts/ and references/ to support build, document, and reference operations

Quick Start

Run a script by providing a notation and subcommand, for example: python3 .plan/execute-script.py plan-marshall:manage-files:manage-files add --plan-id my-plan

Frequently Asked Questions about tools-script-executor

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

FAQPage Schema
What is centralized script execution and how does a proxy manage it?โ–ผ

Centralized script execution uses a single Python proxy entry point to invoke targeted scripts with notation like bundle:skill:script, ensuring consistent environments, standardized error handling, and traceable logging across bundle boundaries.

How do I run a marketplace script using notation and subcommands?โ–ผ

You run a marketplace script by executing the Python proxy and passing notation plus subcommand, such as python3 .plan/execute-script.py plan-marshall:manage-files:manage-files add --plan-id my-plan to invoke the targeted script.

Does centralized script execution support plan-aware workflows and cross-bundle invocation?โ–ผ

Yes, notation-based invocation supports plan-aware workflows by mapping notation to script paths and handling plan context, allowing you to execute scripts across different bundles using the single proxy entry point.

How does script execution logging work for per-plan auditing?โ–ผ

Script execution logging generates both plan-scoped and global logs with trace-plan-id support, capturing results for auditing and ensuring consistent traceability across all marketplace script executions.

Can I extend the script proxy to support build, document, and reference operations?โ–ผ

Yes, the script execution proxy is extensible via scripts/ and references/ directories, allowing you to add support for build, document, and reference operations while maintaining centralized execution and logging.

Why use a single proxy entry point instead of calling scripts directly?โ–ผ

Using a single proxy entry point ensures deterministic behavior, standardized environments, and consistent error handling across all marketplace scripts, eliminating environment inconsistencies and fragmented execution paths.