Skip to content

[Enhancement] Add OpenClaw and Hermes agent framework support #45

@santosomar

Description

@santosomar

Add support for two new AI coding agent frameworks — OpenClaw and Hermes — to the Project CodeGuard converter pipeline. Both frameworks follow the [Agent Skills standard](https://agentskills.io) and use SKILL.md discovery, making them natural extensions of the existing AgentSkillsFormat base class (the same pattern already used for Codex and OpenCode).

Motivation

Project CodeGuard's value increases as it supports to other popular AI agent ecosystems. OpenClaw and Hermes are Agent Skills-compatible frameworks with growing adoption, and users of those tools currently have no way to consume CodeGuard's security skills and rules natively. Adding first-class support means developers using these agents get secure-by-default code generation without manual rule conversion.

Scope of Changes

  • New format classesOpenClawFormat and HermesFormat, both inheriting from AgentSkillsFormat
  • Converter pipeline — Generates .openclaw/ and .hermes/ output directories alongside existing agent formats
  • CI workflows — Build zips and validate generation for both new formats as part of the release pipeline
  • Documentation — Installation tabs for OpenClaw and Hermes added to getting-started.md

Acceptance Criteria

  • OpenClawFormat and HermesFormat classes pass all existing AgentSkillsFormat unit tests
  • codeguard convert produces valid .openclaw/ and .hermes/ output directories
  • CI builds ZIP artifacts for both formats without errors
  • CI validation step confirms generated output matches expected structure
  • getting-started.md includes working installation instructions for both frameworks
  • No regressions in existing format conversions (Cursor, Windsurf, Copilot, Codex, OpenCode, Antigravity)

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions