agent-spec-generator

Generate Glean Agent Builder specifications with JSON and Markdown artifacts.

4|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/ken-cavanagh-glean/fieldkit --skill agent-spec-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-spec-generator
Source: https://github.com/ken-cavanagh-glean/fieldkit/tree/main/plugins/agent-builder/skills/agent-spec-generator
Command: npx skills add https://github.com/ken-cavanagh-glean/fieldkit --skill agent-spec-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables teams to systematically design and generate machine-friendly Glean Agent Builder specifications. It streamlines turning user needs into import-ready agent definitions and accompanying documentation.

Core Features & Use Cases

  • Interview-driven requirements gathering to capture purpose, audience, triggers, inputs, and data sources.
  • Architectural mapping that translates requirements into steps, tools, fields, and model options.
  • Output generation of a valid JSON rootWorkflow for Agent Builder import plus a human-readable Markdown spec.
  • Quick-start templates and prompts to kick off agent design for use cases like new customer onboarding, support automation, and data orchestration.

Quick Start

Use this Skill when starting a new agent. Begin by collecting goals and constraints, map them to steps and tools, then generate both the JSON spec and the Markdown documentation for review.

Frequently Asked Questions about agent-spec-generator

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

FAQPage Schema
How do I generate a Glean Agent specification from requirements?

This Skill generates importable Glean Agent Builder specifications by gathering your requirements through structured interviews, mapping them to agent architecture, and exporting a valid JSON rootWorkflow plus Markdown documentation for review.

What's included in the agent spec output?

The output includes a machine-readable JSON specification ready for Agent Builder import and a human-readable Markdown document describing the agent's purpose, steps, tools, and configuration for stakeholder review.

Can I use this Skill to design agents for specific use cases like customer onboarding or support automation?

Yes. The Skill provides quick-start templates and prompts tailored to common scenarios including new customer onboarding, support automation, and data orchestration to accelerate agent design.

How does the Skill map requirements to agent steps and tools?

The Skill performs architectural mapping that translates your gathered requirements—purpose, audience, triggers, inputs, and data sources—into concrete agent steps, tools, and field configurations enforcing the RootWorkflow schema.

What prerequisites do I need before starting agent design?

Identify your agent's goals, target audience, triggering conditions, expected inputs, and available data sources. The Skill guides you through systematic discovery to capture these requirements.

Does the generated JSON spec work directly with Agent Builder?

Yes. The Skill enforces the RootWorkflow schema throughout generation, producing a valid JSON specification that imports directly into Glean Agent Builder without manual editing.