connector-builder

Generate compiled PROCESIO Custom Action .nupkg connectors from API documentation via an 8-stage LLM pipeline.

4|2|Updated Sep 1, 2026
One-click install
npx skills add https://github.com/Procesio-Externals/procesio-cli --skill connector-builder-procesio-externals
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: connector-builder
Source: https://github.com/Procesio-Externals/procesio-cli/tree/main/tools/connector-builder
Command: npx skills add https://github.com/Procesio-Externals/procesio-cli --skill connector-builder-procesio-externals

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, pyyaml.

What problem does it solve? Building a PROCESIO Custom Action connector by hand requires writing C# code against the PROCESIO SDK, packaging it as a .nupkg, and iterating through compile errors. This Skill drives the AI Connector Builder platform (connector-builder.procesio.app), which turns API documentation into a compiled connector through an 8-stage LLM pipeline (gather, clarify, plan, generate, validate, compile, fix, deliver), so you can go from API docs to an installable .nupkg without writing the connector code yourself. ## Core Features & Use Cases - Full build lifecycle control: Create builds from API doc URLs or pasted documentation, answer clarification questions, approve or revise the plan, approve generated files, and download the compiled .nupkg artifact. - Feedback and iteration loops: Revise plans with free-text feedback, regenerate individual files with instructions, auto-fix validation findings, retry failed stages, and jump between pipeline stages with override-stage. - Builder self-improvement: Edit the platform's knowledge base (prompts, spec modules, examples, validation rules) to change how every future build generates code, plus inspect logs, events, and LLM telemetry for cost and token analysis. - Use Case: Point the builder at a REST API's documentation, walk through the clarify and plan stages, download the resulting .nupkg, then upload it to PROCESIO with customaction-upload to test the connector live in a real process. ## Quick Start Ask the AI to create a connector-builder build from your API documentation URL with your requirements, then gather, answer the clarification questions, approve the plan and generated files, and download the compiled .nupkg artifact.

Frequently Asked Questions about connector-builder

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

FAQPage Schema
How do I build a PROCESIO custom action connector from API documentation?▼

Create a build with create-build passing an API docs URL or pasted documentation and your requirements, then run gather, answer the clarification questions, approve the plan, approve the generated files, and download the compiled .nupkg with download-artifact. Alternatively, start-build runs the entire pipeline as one background task.

How do I install the generated connector into PROCESIO?▼

Download the compiled .nupkg with download-artifact, then upload it using the procesio tool's customaction-upload command with the file path. Confirm installation with customaction-list, and use customaction-delete before re-uploading an updated package.

What authentication does the AI Connector Builder API use?▼

Both auth modes resolve to an Authorization Bearer header. An API key starting with acb_ is used verbatim as the token, while username/password mode posts to /auth/login and uses the returned JWT access token. API key mode is the default when a key is stored.

Why does gather or revise-plan return a 504 error?▼

The synchronous LLM stages can exceed the reverse proxy timeout and return 504 while still completing server-side. Pass --wait to those actions so the tool swallows the 504 and polls get-build until the stage settles, or use wait-build after background stages.

How do I fix a failed connector build or improve generated code?▼

Use retry with --from-step to rerun from a specific stage, revise-plan for plan changes, regenerate-file for single-file fixes, or validate-autofix for validation findings. For systemic generation problems across all builds, edit the knowledge modules (prompts, spec modules, examples) and run reload-config.

Why does compile fail with NU1301 on Ringhel.Procesio.Action.Core?▼

NU1301 means the compiler service cannot reach the GitHub Packages feed hosting the PROCESIO SDK, a server-side PAT scope or egress issue rather than a version problem. The platform administrator must grant the PAT read access to the package, after which retry --from-step 6 completes the build.