skills.rest
rafael-hc
rafael-hcCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

skill-architect

Designs AI skills through phases from discovery to delivery.

Updated Mar 11, 2026
Search Tags:#skill development#workflow automation#prompt engineering#AI agent#SKILL.md#skill architecture
One-click install
npx skills add https://github.com/rafael-hc/AoPonto-FoodService --skill skill-architect-rafael-hc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-architect
Source: https://github.com/rafael-hc/AoPonto-FoodService/tree/main/.agents/skills/skill-architect
Command: npx skills add https://github.com/rafael-hc/AoPonto-FoodService --skill skill-architect-rafael-hc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill provides a structured, conversational framework to guide users through the entire process of designing and building high-quality AI skills from scratch, ensuring clarity, efficiency, and adherence to best practices.

Core Features & Use Cases

  • Guided Skill Development: Walks users through Discovery, Architecture, Craft, Validate, and Deliver phases.
  • Best Practice Enforcement: Ensures adherence to naming conventions, description formats, and progressive disclosure principles.
  • Use Case: A user wants to automate a customer support workflow. They can engage this Skill to define the problem, design the skill's structure, write the SKILL.md file, and validate its effectiveness before deployment.

Quick Start

Use the skill-architect to help me create a new skill for managing GitHub pull requests.

Frequently Asked Questions about skill-architect

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

FAQPage Schema
How do I design and build AI skills from scratch?▼

To design and build AI skills from scratch, follow a structured conversational process covering problem definition, architectural decisions, content crafting, validation, and delivery to ensure discoverability and efficiency.

What is progressive disclosure in skill architecture?▼

Progressive disclosure in skill architecture is an interaction principle that structures information delivery, ensuring AI agents receive only the necessary context for a specific task without being overwhelmed by excessive data.

How do I write a SKILL.md file for workflow automation?▼

Writing a SKILL.md file for workflow automation involves crafting content during a dedicated architectural phase, ensuring adherence to naming conventions, description formats, and best practices for agent interaction.

What are the best practices for AI agent skill development?▼

Best practices for AI agent skill development include adhering to naming conventions, enforcing progressive disclosure principles, and validating composability and effectiveness before final deployment.

Does skill-architect support customer support workflow automation?▼

Yes, skill-architect supports customer support workflow automation by guiding you through problem definition, structural design, SKILL.md file creation, and effectiveness validation before deployment.

Why does prompt engineering matter for AI agent composability?▼

Prompt engineering matters for AI agent composability because it ensures the structured reasoning and architectural decisions defined in the skill can be efficiently chained and reused across multiple workflows.

Related Skills

Explore More Software Engineering Skills→
yu13130122297yu13130122297

scout

Identify uncertainties in research framing, datasets, metrics, and baselines.

Community
Intermediate
nearnear
14

near-ai

Automates creation, discovery, and governance of modular NEAR AI agents.

Official
Advanced
chengyihuachengyihua

skill-creator

Automates creation and packaging of modular Skill Units with SKILL.md.

Community
Advanced
az9713az9713

system-prompts

A tool for generating/maintaining documentation for arbitrary Unix-style command-line tools.

Community
Advanced