executor-and-skills

Discovers and invokes Executor MCP integrations for cross-agent messaging, Cloudflare, and Apple Pro apps.

Updated Oct 15, 2019
One-click install
npx skills add https://github.com/kkkaoru/dotfiles --skill executor-and-skills-kkkaoru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: executor-and-skills
Source: https://github.com/kkkaoru/dotfiles/tree/main/tools/executor-skills/skills/executor-and-skills
Command: npx skills add https://github.com/kkkaoru/dotfiles --skill executor-and-skills-kkkaoru

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents context bloat and misconfiguration by loading integration schemas and domain skill guidance on demand through the Executor CLI instead of preloading every MCP tool into the agent's startup prompt. ## Core Features & Use Cases - On-demand skill loading: Search, describe, and read installed skills (agmsg, ctx, Cloudflare, MotherDuck, GPUI, web-performance) through the local-skills integration before starting domain work. - Service tool discovery: Find and call Cloudflare, MotherDuck, context7, Chrome DevTools, and Apple Pro apps integrations via executor tools search/describe/call with schema-valid paths. - Cross-agent messaging and history: Route agmsg messaging and ctx session-history searches through Executor with explicit project, team, and agent identity verification. - Use Case: When asked to deploy a Cloudflare Worker, you first search the cloudflare-docs integration for guidance, read the relevant skill, then discover and call the cloudflare-api tools with least-privilege OAuth scopes. ## Quick Start Ask the agent to search Executor for the Cloudflare documentation tools and use them to look up how to configure a Workers KV binding.

Frequently Asked Questions about executor-and-skills

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

FAQPage Schema
How do I discover and call Executor MCP tools?

Run `executor tools search '<term>' --namespace <ns> --limit N` to find tools, `executor tools describe '<path>'` for the exact schema, then `executor call <path> '{"arg":"value"}'`. Never guess namespaces or print every schema.

How do I load a skill through the local-skills integration?

Search with `executor tools search 'search_skills' --namespace local-skills`, describe the returned path, call it with a focused query, then call `read_skill` for the selected ID. Use `read_reference` with offset and limit for referenced files.

How do I send agmsg messages through Executor?

Discover tools with `executor tools search 'agmsg_whoami' --namespace agmsg`, then pass the originating Pi project's absolute path plus explicit project, team, and agent values. The server verifies the identity is registered before sending.

Does Executor work with Cloudflare without OAuth setup?

No. Cloudflare integrations require OAuth connection authorization first. Use the executor-cloudflare-auth.sh helper from the dotfiles scripts directory, which handles discovery, dynamic client registration, and opens the authorization URL for browser consent.

What happens when Executor is unavailable?

For skills, fall back to searching local SKILL.md files with ripgrep under ~/.agents/skills and ~/.pi/agent/skills, then read them directly. For agmsg and ctx services, report the failure rather than bypassing Executor or reading storage directly.

Why does an Executor call show zero exit code but no result?

A zero CLI exit can still mean execution paused for approval or a tool error occurred. Check the output for 'Execution paused', show the user the exact action and approval URL, and resume only with explicit approval using the execution ID.