Skip to content

Latest commit

 

History

History
245 lines (162 loc) · 10.1 KB

File metadata and controls

245 lines (162 loc) · 10.1 KB

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

Frameworks & Methodologies

Structured reasoning frameworks and domain-specific methodologies for systematic problem-solving.

🧠 First Principles Framework (FPF Core)

Root framework providing auditable thinking, evidence chains, and systematic problem-solving patterns. Serves as the governing foundation for all DPF and LPF skills.

Use when:

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

Reference: GitHub Repository of the original First Principles Framework by Anatoly Levenchuk

Location: skills/fpf-core/

⚡ FPF Narrative Prose

Generates compact, unambiguous FPF-structured output at F4-F5 formality level using typed-slot notation. Designed for AI agent consumers and FPF-literate humans where token economy and auditability matter — diagnostics, architecture decisions, code reviews, status reports, trust assessments, system compositions. Replaces verbose prose (~65% token savings, lossless).

Depends on: fpf-core

Use when:

  • Writing diagnostics, ADRs, code reviews, or status reports for AI agent consumers
  • Composing trust/assurance assessments with F-G-R-CL tuples
  • Building Γ (gamma) system/epistemic compositions with Quintet invariants
  • Reconstructing clean prose from FPF blocks (removing all metadata)
  • Any context where token economy AND auditability matter

Do NOT use for: casual chat, teaching, non-technical audiences, creative tasks.

Location: skills/fpf-narrative/

📖 FPF Literacy & DPF Authoring

Helps agents understand the FPF/DPF/LPF stack, create new domain practical frameworks (DPFs), load domain knowledge, distinguish FPF-grounded answers from generic AI responses, and choose the right carrier for publication.

Depends on: fpf-core

Use when:

  • Teaching an agent the FPF ecosystem and its layers
  • Creating a new DPF from scratch (~1 hour draft)
  • Distinguishing vanilla AI answers from FPF-grounded reasoning
  • Deciding whether to publish in-chat vs as a file

Location: skills/dpf-fpf-literacy/

🏗️ Layered Framework Workspace Architecture

Manages the FPF/DPF/LPF workspace structure: where to place frameworks, how to organize skill carriers, dependency chains, and LPF vs Project boundaries.

Depends on: fpf-core, dpf-fpf-literacy

Use when:

  • Organizing the FPF/DPF/LPF workspace layout
  • Deciding where a new framework belongs in the ecosystem
  • Setting up skill-carrier structure for a DPF/LPF
  • Resolving LPF vs Project boundary questions
  • Packaging a DPF/LPF as a distributable skill

Location: skills/dpf-lfw-architecture/

Business Analysis & Requirements Engineering

Domain practical framework for structured business analysis and requirements engineering in engineering projects.

📋 Business Analysis & Requirements Engineering

Covers the full requirements lifecycle: stakeholder identification, elicitation, specification, prioritization, validation, traceability, and change management. Includes business process modeling, use case modeling, and data/security requirements.

Depends on: fpf-core

Use when:

  • Identifying and managing stakeholders
  • Eliciting, specifying, or prioritizing requirements
  • Validating or tracing requirements
  • Managing requirements changes
  • Modeling business processes or use cases
  • Defining data or security requirements

Location: skills/dpf-business-analysis/

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/

Document Processing

Skills for converting and extracting content from document formats.

📄 PDF to Markdown (pdf2md)

Extracts PDF content into clean Markdown: text via pdfplumber + image/diagram descriptions via a local vision-language model (LM Studio, Ollama, or any OpenAI-compatible endpoint). Supports recursive batch processing, resume/retry, and custom VL prompts.

Use when:

  • Converting presentation decks (slides, diagrams) to text
  • Extracting conference talks, workshops, or technical reports from PDF
  • Transcribing PDFs where plain text extraction is garbled
  • Batch-processing directories of PDFs with automatic skip of already-processed files

Do NOT use for: pure-text PDFs (use pdfplumber directly), filling PDF forms (use the pdf skill), scanned documents without selectable text.

Dependencies: pip install pdfplumber pypdfium2 pillow requests + local VL model (default: qwen/qwen3-vl-8b via LM Studio).

Location: skills/pdf2md/

Development Tools

Tools for creating and managing AI agent skills and FPF/DPF/LPF documentation.

🔄 FPF Sync

Keeps the fpf-core skill in sync with the canonical FPF monolith (FPF-Spec.md). Self-contained tool that pulls the latest spec, decompiles it into atomic reference files, and updates the skill metadata.

Use when:

  • The FPF specification has been updated (new commits upstream)
  • The fpf-core skill references are stale or show wrong counts
  • Running scheduled maintenance on layered framework workspace skills

Dependencies: Python 3.10+, git in PATH.

Location: skills/fpf-sync/

🔧 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 structured markdown vault: atomic decision cards (DEC-NNNN), open question cards (Q-NNNN), risk cards (RISK-NNNN), contradiction cards (CON-NNNN), event chronicles, and source digests. Includes scaffold for bootstrapping a new vault, templates for digests/decisions/agendas, and inbox processing.

Use when:

  • Initializing a project vault from scaffold
  • Processing meeting transcripts into digests with atomic decision/question/risk/contradiction cards
  • Updating project state from dialogue briefings (owner chat updates)
  • Generating next-meeting agendas from open questions, blockers, and contradictions
  • Reconciling new information against the open question registry
  • Surfacing contradictions and archiving closed entities

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/