skill-builder

Guides interactive workshops to design and generate SKILL.md or agent definition files.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/nugiwabot/marketing-branding-selling-ads-skills --skill skill-builder-nugiwabot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-builder
Source: https://github.com/nugiwabot/marketing-branding-selling-ads-skills/tree/main/.agents/skills/skill-builder
Command: npx skills add https://github.com/nugiwabot/marketing-branding-selling-ads-skills --skill skill-builder-nugiwabot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designing a new AI skill or agent often leads to vague outcomes, over-engineered tools, and inconsistent file structures. This Skill walks you through a structured workshop that enforces best practices and outputs a production-ready SKILL.md or agent definition file. ## Core Features & Use Cases - Skill vs Agent Decision Framework: Determines whether your use case needs an interactive skill or an autonomous agent using a clear decision rule. - Four-Question Design Process: Defines outcome, required inputs, allowed actions, and rules before any file is generated. - Anti-Pattern Detection: Pushes back on over-engineering, vague outcomes, premature multi-agent setups, and tool overload. - Use Case: You want to turn blog posts into email sequences. The workshop helps you scope the outcome, pick minimal tools, and generates a complete SKILL.md plus 10 test cases covering standard, edge, and adversarial inputs. ## Quick Start Ask the assistant to help you design a new skill or agent and describe what you want it to do in one sentence.

Frequently Asked Questions about skill-builder

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

FAQPage Schema
How do I decide between building a skill or an agent?

Choose a skill when the user participates in the process, such as content generation or guided workshops. Choose an agent when the user delegates fully and receives results, such as autonomous review or research tasks.

How do I create a new SKILL.md file for my project?

Run the workshop, answer the four design questions about outcome, inputs, actions, and rules, then receive a complete SKILL.md with frontmatter, step-by-step instructions, output format, and a review checklist.

What questions should I answer before designing an AI agent?

Define the specific outcome it produces, the information it requires, the actions and tools it is allowed to use, and the rules or quality standards it must follow. Vague answers like 'help with business' are rejected.

When should I avoid building multiple agents?

Avoid multi-agent setups until a single agent with good tools clearly struggles with distinct tasks. Start with one agent or a simpler workflow pattern like prompt chaining or routing, and add complexity only when evidence demands it.

What are common mistakes when designing AI skills?

Common anti-patterns include over-engineering with too many tools, vague outcomes without a concrete deliverable, premature multi-agent coordination, and tool overload. Start with one job, one output format, and minimal tools.