greywater-recycling-constructed-wetland

Greywater Recycling Constructed Wetland — Skill Registry Documentation

Version

2.0.0 — Production-grade release with flexible agent architecture

Overview

This skill provides a production-grade harness for On-Site Greywater Treatment & Constructed Wetland Engineering analysis. It transforms Claude Code into a domain expert that delivers structured, evidence-backed outputs through:

1. Flexible Agent Architecture — Dynamic skill routing with chain-of-thought decision making
2. Modular Skill Registry — Type-safe skill registration with input/output validation
3. Lifecycle Hooks — Pre/post execution hooks for monitoring and control
4. Quality Gates — 10 validation gates (6 universal + 4 domain) with auto-fix
5. Graceful Degradation — 5-level fallback system with explicit limitation flags
6. Knowledge Pipeline — Automated crawl pipeline for continuous learning

---

Skill Registration

How Skills Are Registered

All skills are registered in config/skills_init.py through the initialize_skills() function. Each skill is registered with comprehensive metadata:

from config import SkillMetadata, SkillCategory, SkillInputSchema, SkillOutputSchema, register_skill

register_skill(SkillMetadata(
    name="sub-core-analysis",
    version="2.0.0",
    category=SkillCategory.SUB_SKILL,
    description="Design a household greywater treatment system...",
    author="972026 Skill Library",
    license="MIT",
    tags=["analysis", "design", "wetland-sizing"],
    input_schema=SkillInputSchema(...),
    output_schema=SkillOutputSchema(...),
    dependencies=["sub-evidence-collector"],
    token_budget=4000,
    file_path=Path("skills/sub-core-analysis.md")
))

Skill Metadata Schema

interface SkillMetadata {
    // Identity
    name: string;                    // Unique skill identifier
    version: string;                 // Semantic version (major.minor.patch)
    category: SkillCategory;         // harness | sub_skill | utility | validator | transformer
    description: string;             // Detailed description for triggering
    author: string;                  // Author/organization
    license: string;                 // License identifier (SPDX)
    tags: string[];                  // Keywords for discovery

    // Input/Output Contracts
    input_schema: SkillInputSchema;  // Input validation schema
    output_schema: SkillOutputSchema; // Output validation schema

    // Dependencies
    dependencies: string[];          // Skills that must complete first

    // Execution Constraints
    token_budget: int;               // Maximum tokens per execution
    max_execution_time_seconds: int;  // Timeout threshold
    retry_count: int;                // Number of retries on failure

    // State
    enabled: bool;                   // Whether skill is active
    file_path: Path | null;          // Path to skill .md file
}