Agent skills

The Prefactor agent skills are a set of instruction files that teach coding tools and AI agents how to work with Prefactor. Once installed, your coding tool can bootstrap Prefactor resources, instrument an existing agent, populate risk data on spans, and build custom provider adapters — without you having to explain the patterns each time.

The skills live in the Prefactor TypeScript SDK repository but cover patterns that apply across any supported framework.

What the skills cover

• Bootstrap existing agent with Prefactor CLI — provision the environment, agent, and instance resources via the CLI before adding instrumentation code.
• Instrument existing agent with Prefactor SDK — add tracing for runs, LLM calls, tool calls, and failures to an agent that already works.
• Report agent risk data — populate data_risk fields on span types for compliance tracking and data governance.
• Create provider package with core — build a custom adapter on top of @prefactor/core when no built-in adapter exists for your framework.

Install via the skills CLI

bunx skills add https://github.com/prefactordev/typescript-sdk/

This fetches the skills from the SDK repository and installs them into your coding tool’s local skills directory.

Install via an agent

If your tool does not support the skills CLI, paste the following into your agent as a prompt:

Clone the skills repo to a temporary folder, copy the skill folders, then delete the clone.

1) git clone https://github.com/prefactordev/typescript-sdk /tmp/prefactor-skills
2) Copy the folders into your coding tool's local skills directory:
   - /tmp/prefactor-skills/skills
3) Delete the temporary clone:
   rm -rf /tmp/prefactor-skills

The agent will run the steps and install the skills into the right place for your tool.