Custom Agent Skills Collection

Custom skills for AI agents that provide specialized domain knowledge and structured methodologies.

How to Use

These skills are designed to be automatically used by an AI agent when a user asks for help with a task covered by one of the skills.

Installation

1. Clone or download skills folder and its contents.
2. Add skills from the skills folder to your IDE / CLI Code tool:
   • Cursor: ~/.cursor/skills
   • Cloude Code: ~/.claude/skills/
   • Other IDE or AI agent: check documentation on where skills are located
3. Ask AI-agent to use the skill during task execution.

Usage

Example workflow:

• User: "Help me plan my bathroom layout"
• AI: Loads bathroom-planner/SKILL.md srom skills and applies the 10-stage methodology
• AI guides user through measurements, zone planning, ergonomics, and implementation

The skills transform the AI into a specialized assistant that follows proven methodologies rather than ad-hoc responses.

Table of Contents

• Thinking Methodologies
  • First Principles Framework
• Text Analysis & Writing
  • Reverse-Engineering Texts
• Development Tools
  • Spec Decomposer
  • Agent Skill Builder
• Project Management
  • Project Vault
• Space Planning & Organization
  • Bathroom Planner
  • Wardrobe Planner

Thinking Methodologies

Frameworks for structured reasoning and systematic problem-solving.

🧠 First Principles Framework (FPF)

Structured reasoning skill for any task requiring auditable thinking, evidence chains, systematic problem-solving, or holonic composition.

Use when:

• Guiding reasoning on engineering, research, and management tasks
• Requiring systematic evidence-based problem-solving
• Building structured, verifiable solutions

Reference: FPF GitHub Repository

Location: skills/fpf/

Text Analysis & Writing

Skills for analyzing existing texts and extracting reusable structure, argumentation, and rhetorical patterns.

🔍 Reverse-Engineering Texts

Reverse-engineer texts into a reusable structural blueprint (reverse outlining, argument mining, copy teardown).

Use when:

• Analyzing a text’s thesis, hook, and macro-structure
• Extracting argument maps and support/evidence moves
• Mapping rhetoric (Ethos/Pathos/Logos)
• Converting “text → structure/blueprint” to reuse patterns in writing, specs, prompts, or marketing

Location: skills/reverse-engineering-texts/

Development Tools

Tools for creating and managing AI agent skills and documentation.

📚 Spec Decomposer

Decompose large unified specifications into agent skills with progressive disclosure.

Use when:

• Converting documentation, frameworks, or knowledge bases exceeding 50KB
• Creating properly structured skills that Claude can navigate efficiently
• Implementing multi-level progressive disclosure for large content

Location: skills/spec-decomposer/

🔧 Agent Skill Builder

Guide for deciding when to create agent skills, how to design them well, and what anti-patterns to avoid. Covers the four-layer agent guidance stack (AGENTS.md, Skills, MCP, Memory), atomicity principles, and quality gates.

Use when:

• Creating a new skill or reviewing an existing one
• Deciding between skills vs AGENTS.md vs MCP vs Memory
• Designing atomic, reusable skills with progressive disclosure
• Unsure if a skill is needed at all

Location: skills/create-agent-skill/

Project Management

Skills for tracking project state, decisions, risks, and dependencies in a structured markdown vault.

🗂️ Project Vault

Maintains project state in a markdown vault (tasks, dependencies, risks, key decisions, open questions, agendas, reports) from meeting transcripts, structured notes, or owner chat updates.

Use when:

• Initializing a project vault in a new repository
• Updating project state from meeting transcripts or user briefings
• Managing stakeholders and responsibilities
• Generating status reports, open question lists, or meeting agendas
• Surfacing contradictions and risks across project canon

Location: skills/project-vault/

Space Planning & Organization

Skills for optimizing physical spaces and organizing belongings with systematic methodologies.

🚿 Bathroom Planner

Structured 10-stage methodology for planning bathroom layouts with focus on ergonomics, functionality, and safety.

Use when:

• Planning bathroom furniture placement
• Optimizing bathroom space
• Arranging bathroom fixtures (toilet, sink, bathtub, washing machine)
• Solving bathroom layout challenges

Applicable to: Large bathrooms (10+ square meters) with flexible plumbing.

Location: skills/bathroom-planner/

🧥 Wardrobe Planner

Structured 7-stage methodology for planning wardrobe/closet organization based on First Principles Framework.

Use when:

• Organizing closet space
• Planning wardrobe storage
• Arranging clothing and accessories
• Optimizing closet layout
• Solving wardrobe organization challenges

Location: skills/wardrobe-planner/