Guided Build

A skill that turns your coding agent into a project lead. It walks you through building a real AI pipeline step by step, teaching the architecture as you go.

Default project: A system that turns meeting transcripts into polished proposals automatically.

The skill covers six phases, each one a real piece of how AI systems are built:

1. Input - Get meeting data into the system
2. Template - Define what the output should look like
3. Generation - Wire input and template together through an AI call
4. Storage - Send the result somewhere real
5. Scheduling - Run the whole thing automatically
6. Wrap - Bundle everything into one command

You don't need to know what pieces you need or how they connect. The agent drives the conversation, explains each concept before building, presents options with tradeoffs, and waits for your decision at every step.

---

Install

Option A: Use npx skills (recommended)

If you already use a supported coding agent (Claude Code, Cursor, Codex, Cline, Zed, etc.), install the skill directly into your agent's config:

# From this repo (local install)
npx skills add .

# Or once published to GitHub
npx skills add aspectrr/ai-learning

Install it globally so it's available in every project:

npx skills add . -g

Target a specific agent:

npx skills add . -a claude-code
npx skills add . -a cursor
npx skills add . -a codex

List what's available before installing:

npx skills add . --list

Option B: Try it without installing

Run the skill once in a temporary directory without committing to anything:

# Generate the prompt and pipe it to your agent
npx skills use . | claude

# Or start a specific agent with the skill loaded
npx skills use . --agent claude-code

Option C: Manual install

Copy the SKILL.md file from this repo into your agent's skills directory:

Agent	Project path	Global path
Claude Code	.claude/skills/guided-build/	~/.claude/skills/guided-build/
Cursor	.cursor/skills/guided-build/	~/.cursor/skills/guided-build/
Codex	.agents/skills/guided-build/	~/.config/agents/skills/guided-build/
Cline	.cline/skills/guided-build/	~/.cline/skills/guided-build/
Pi	.pi/agent/skills/guided-build/	~/.pi/agent/skills/guided-build/

Just create the directory and copy SKILL.md into it.

---

Use it

Once installed, open your coding agent in an empty project directory and start a conversation. The skill activates automatically when you describe what you want to build:

I want to build a system that takes meeting transcripts and generates proposals automatically.

Or be explicit:

Use the guided-build skill. I want to build an AI pipeline for [your goal].

The agent will ask you three questions:

1. What do you want to build? (it has a default if you're not sure)
2. What environment are you working in? (OS, languages, tools you have installed)
3. How do you learn best? (deep explanation first, or see it work first)

Then it walks you through the six phases, building each piece with you in your real project.

---

What you end up with

A real project directory with:

your-project/
  transcripts/        # Where meeting data goes in
  templates/          # Output structure and style rules
  output/             # Generated proposals land here
  generate.js         # The AI generation script
  save.js             # Saves output to your chosen location
  pipeline.js         # The full pipeline, one command
  .github/workflows/  # Scheduling (if you chose GitHub Actions)
  README.md           # How to set up and run everything

Plus a git history with a commit for each phase, so you can always go back.

---

Customization

The default pipeline builds a meeting-to-proposal system. But the architecture is the same for any AI automation. To use it for a different goal, just describe what you want when you start:

I want to build a system that turns customer feedback into social media posts.

I want to build a system that generates weekly status reports from our project management tool.

The skill adapts the six phases to whatever you're building. The pieces stay the same (input, template, generation, storage, scheduling, wrap). The specifics change.

---

Requirements

You need:

• A coding agent that supports skills (Claude Code, Cursor, Codex, Cline, pi, or any agent that reads SKILL.md files)
• Node.js or Python installed (for running the pipeline scripts)
• An API key for an AI provider (OpenAI or Anthropic). The skill walks you through getting one if you don't have it.

No prior experience with MCP servers, cron, or version control needed. The skill teaches each concept as it becomes relevant.