Skip to content

LeoYeAI/agent-master-skills / skills/agent-harness

agent-harness

Verified

Use when an agent should drive a goal in one of this repo's domains to a verified close, before starting the work. Compiles the goal into a task plan with goal_compiler.py and runs it through loop_controller.py, which verifies each task, caps retries and escalates.

assets/harnesses/markdown-html.json

View on GitHub
{
  "schema": "agent-harness/manifest.v1",
  "domain": "markdown-html",
  "skill_count": 5,
  "loop_defaults": {
    "max_attempts_per_task": 3,
    "max_loop_iterations": 12,
    "escalate_on": [
      "attempts_exhausted",
      "no_verification_available",
      "destructive_or_irreversible_action",
      "goal_drift_detected"
    ]
  },
  "skills": [
    {
      "name": "design-system",
      "path": "markdown-html/skills/design-system",
      "description": "Use when setting up brand settings before the first markdown-to-HTML conversion, or changing them. Runs a 10-question onboarding with onboard.py (colors, fonts, style, TOC) and refuses palettes that fail WCAG AA via brand_palette_validator.py.",
      "tools": [
        {
          "script": "markdown-html/skills/design-system/scripts/brand_palette_validator.py",
          "wired": true,
          "supports_sample": true,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/design-system/scripts/brand_palette_validator.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            },
            {
              "cmd": "python3 markdown-html/skills/design-system/scripts/brand_palette_validator.py --sample",
              "expect_exit": 0,
              "kind": "sample"
            }
          ]
        },
        {
          "script": "markdown-html/skills/design-system/scripts/config_loader.py",
          "wired": true,
          "supports_sample": true,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/design-system/scripts/config_loader.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            },
            {
              "cmd": "python3 markdown-html/skills/design-system/scripts/config_loader.py --sample",
              "expect_exit": 0,
              "kind": "sample"
            }
          ]
        },
        {
          "script": "markdown-html/skills/design-system/scripts/onboard.py",
          "wired": true,
          "supports_sample": false,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/design-system/scripts/onboard.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            }
          ]
        }
      ],
      "agentic_signals": {
        "goal_intake": true,
        "refusal_gate": true,
        "verification": false,
        "loop_discipline": false,
        "close_out": false
      },
      "references": [
        "design_token_canon.md",
        "typography_pairing.md",
        "wcag_accessibility.md"
      ]
    },
    {
      "name": "markdown-html-orchestrator",
      "path": "markdown-html/skills/markdown-html-orchestrator",
      "description": "Use when the user wants a markdown file turned into a single-file interactive HTML page (document, code review or slide deck). Classifies it with doctype_classifier.py and routes to md-document, md-review or md-slides.",
      "tools": [
        {
          "script": "markdown-html/skills/markdown-html-orchestrator/scripts/doctype_classifier.py",
          "wired": true,
          "supports_sample": true,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/markdown-html-orchestrator/scripts/doctype_classifier.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            },
            {
              "cmd": "python3 markdown-html/skills/markdown-html-orchestrator/scripts/doctype_classifier.py --sample",
              "expect_exit": 0,
              "kind": "sample"
            }
          ]
        },
        {
          "script": "markdown-html/skills/markdown-html-orchestrator/scripts/output_path_resolver.py",
          "wired": true,
          "supports_sample": true,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/markdown-html-orchestrator/scripts/output_path_resolver.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            },
            {
              "cmd": "python3 markdown-html/skills/markdown-html-orchestrator/scripts/output_path_resolver.py --sample",
              "expect_exit": 0,
              "kind": "sample"
            }
          ]
        },
        {
          "script": "markdown-html/skills/markdown-html-orchestrator/scripts/route_explainer.py",
          "wired": true,
          "supports_sample": false,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/markdown-html-orchestrator/scripts/route_explainer.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            }
          ]
        }
      ],
      "agentic_signals": {
        "goal_intake": true,
        "refusal_gate": true,
        "verification": false,
        "loop_discipline": false,
        "close_out": true
      },
      "references": [
        "information_density_canon.md",
        "orchestrator_routing_patterns.md",
        "single_file_html_discipline.md"
      ]
    },
    {
      "name": "md-document",
      "path": "markdown-html/skills/md-document",
      "description": "Use when converting long-form markdown (spec, RFC, report, plan) into a single-file HTML page with sticky TOC, search and code-copy. Parses with markdown_parser.py and renders with html_renderer.py using the design-system brand.",
      "tools": [
        {
          "script": "markdown-html/skills/md-document/scripts/html_renderer.py",
          "wired": true,
          "supports_sample": true,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/md-document/scripts/html_renderer.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            },
            {
              "cmd": "python3 markdown-html/skills/md-document/scripts/html_renderer.py --sample",
              "expect_exit": 0,
              "kind": "sample"
            }
          ]
        },
        {
          "script": "markdown-html/skills/md-document/scripts/interactivity_injector.py",
          "wired": true,
          "supports_sample": true,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/md-document/scripts/interactivity_injector.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            },
            {
              "cmd": "python3 markdown-html/skills/md-document/scripts/interactivity_injector.py --sample",
              "expect_exit": 0,
              "kind": "sample"
            }
          ]
        },
        {
          "script": "markdown-html/skills/md-document/scripts/markdown_parser.py",
          "wired": true,
          "supports_sample": true,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/md-document/scripts/markdown_parser.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            },
            {
              "cmd": "python3 markdown-html/skills/md-document/scripts/markdown_parser.py --sample",
              "expect_exit": 0,
              "kind": "sample"
            }
          ]
        }
      ],
      "agentic_signals": {
        "goal_intake": true,
        "refusal_gate": true,
        "verification": true,
        "loop_discipline": false,
        "close_out": false
      },
      "references": [
        "information_density_patterns.md",
        "single_file_html_discipline.md",
        "toc_and_nav_ux.md"
      ]
    },
    {
      "name": "md-review",
      "path": "markdown-html/skills/md-review",
      "description": "Use when converting a markdown code review with diff blocks and severity callouts into a two-column HTML review. Parses diffs with diff_parser.py and annotations with annotation_extractor.py; requires a named reviewer.",
      "tools": [
        {
          "script": "markdown-html/skills/md-review/scripts/annotation_extractor.py",
          "wired": true,
          "supports_sample": true,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/md-review/scripts/annotation_extractor.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            },
            {
              "cmd": "python3 markdown-html/skills/md-review/scripts/annotation_extractor.py --sample",
              "expect_exit": 0,
              "kind": "sample"
            }
          ]
        },
        {
          "script": "markdown-html/skills/md-review/scripts/diff_parser.py",
          "wired": true,
          "supports_sample": true,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/md-review/scripts/diff_parser.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            },
            {
              "cmd": "python3 markdown-html/skills/md-review/scripts/diff_parser.py --sample",
              "expect_exit": 0,
              "kind": "sample"
            }
          ]
        },
        {
          "script": "markdown-html/skills/md-review/scripts/review_html_renderer.py",
          "wired": true,
          "supports_sample": true,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/md-review/scripts/review_html_renderer.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            },
            {
              "cmd": "python3 markdown-html/skills/md-review/scripts/review_html_renderer.py --sample",
              "expect_exit": 0,
              "kind": "sample"
            }
          ]
        }
      ],
      "agentic_signals": {
        "goal_intake": true,
        "refusal_gate": true,
        "verification": false,
        "loop_discipline": true,
        "close_out": false
      },
      "references": [
        "diff_rendering_canon.md",
        "pr_annotation_ux.md",
        "severity_coding.md"
      ]
    },
    {
      "name": "md-slides",
      "path": "markdown-html/skills/md-slides",
      "description": "Converts a markdown deck (slides separated by `---` HR boundaries or by `# ` H1 headings, with optional HTML-comment `notes:` presenter-notes blocks) into a single-file HTML presentation with arrow-key / space / PgDn / PgUp / Home / End / P / Esc keyboard navigation, presenter mode (split view with current slide + speaker notes + clock + next-slide preview), URL-hash deep linking, and `@media print` page-per-slide for PDF export. Triggers when the markdown-html-orchestrator classifies an input as SLIDES, or when invoked directly via /cs-md-slides. Reuses md-document's markdown parser for \u2026",
      "tools": [
        {
          "script": "markdown-html/skills/md-slides/scripts/deck_html_renderer.py",
          "wired": true,
          "supports_sample": true,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/md-slides/scripts/deck_html_renderer.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            },
            {
              "cmd": "python3 markdown-html/skills/md-slides/scripts/deck_html_renderer.py --sample",
              "expect_exit": 0,
              "kind": "sample"
            }
          ]
        },
        {
          "script": "markdown-html/skills/md-slides/scripts/presenter_notes_parser.py",
          "wired": true,
          "supports_sample": true,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/md-slides/scripts/presenter_notes_parser.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            },
            {
              "cmd": "python3 markdown-html/skills/md-slides/scripts/presenter_notes_parser.py --sample",
              "expect_exit": 0,
              "kind": "sample"
            }
          ]
        },
        {
          "script": "markdown-html/skills/md-slides/scripts/slide_splitter.py",
          "wired": true,
          "supports_sample": true,
          "verification": [
            {
              "cmd": "python3 markdown-html/skills/md-slides/scripts/slide_splitter.py --help",
              "expect_exit": 0,
              "kind": "smoke"
            },
            {
              "cmd": "python3 markdown-html/skills/md-slides/scripts/slide_splitter.py --sample",
              "expect_exit": 0,
              "kind": "sample"
            }
          ]
        }
      ],
      "agentic_signals": {
        "goal_intake": true,
        "refusal_gate": true,
        "verification": false,
        "loop_discipline": false,
        "close_out": false
      },
      "references": [
        "keyboard_nav_patterns.md",
        "presentation_ux.md",
        "single_file_deck_conventions.md"
      ]
    }
  ]
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall