skill-architect

Name: skill-architect
Availability: InStock
Author: paulokakoma

Guide users through Discovery and Architecture before generating SKILL.md.

Updated Nov 19, 2025

Search Tags:#workflow #architecture #validation #discovery #patterns #skill #frontmatter

Ready to run

npx skills add https://github.com/paulokakoma/ecokambio --skill skill-architect-paulokakoma

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-architect
Source: https://github.com/paulokakoma/ecokambio/tree/main/.cursor/skills/skill-architect
Command: npx skills add https://github.com/paulokakoma/ecokambio --skill skill-architect-paulokakoma

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide helps teams design and build high-quality skills from scratch by enforcing a Discovery → Architecture → Craft → Validate → Deliver process, ensuring deliberate, modular SKILL.md creation instead of ad-hoc templates.

Core Features & Use Cases

Phase-driven design: Define discovery goals, architecture decisions, and craft criteria before writing SKILL.md.
Frontmatter discipline: Enforce mandatory frontmatter fields, versioning, and progressive disclosure.
Quality gates: Integrated validation, anti-pattern checks, and test phrases to ensure reliable delivery.

Quick Start

Define 2–3 concrete use cases, choose the primary pattern, and draft the frontmatter and architecture plan before writing the SKILL.md.

Frequently Asked Questions about skill-architect

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

FAQPage Schema

How do I create a reusable skill from an existing workflow?▼

To create a reusable skill from an existing workflow, define discovery goals, choose a primary pattern, and draft frontmatter before generating the SKILL.md file. This process enforces modularity and progressive disclosure, turning ad-hoc workflows into deliberate, ready-to-ship skills.

What is the best way to structure a SKILL.md file for an AI agent?▼

The best way to structure a SKILL.md file is by following a disciplined workflow: Discovery, Architecture, Craft, Validate, and Deliver. This ensures deliberate creation with mandatory frontmatter fields, versioning, and clear success criteria for agent consistency.

How does frontmatter validation improve skill architecture?▼

Frontmatter validation improves skill architecture by enforcing mandatory fields and versioning early in the design process. This discipline prevents ad-hoc templates and ensures the final SKILL.md meets quality gates and anti-pattern checks for reliable delivery.

Can I use this approach to build standalone skills and MCP-enhanced workflows?▼

Yes, you can use this approach to build both standalone skills and MCP-enhanced workflows. The architecture process addresses turning workflows into reusable skills and automating tasks by applying progressive disclosure and validation to both contexts.

What are the limitations of generating SKILL.md without discovery and architecture phases?▼

Generating SKILL.md without discovery and architecture phases leads to ad-hoc templates lacking modularity. Skipping these phases risks failing quality gates, missing frontmatter validation, and delivering inconsistent agent actions without clear success criteria.