policy-runner

Execute policy-as-code checks from policy_plan.md and write summary reports.

5|Updated Nov 26, 2025
One-click install
npx skills add https://github.com/EffortlessMetrics/demo-swarm --skill policy-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: policy-runner
Source: https://github.com/EffortlessMetrics/demo-swarm/tree/main/.claude/skills/policy-runner
Command: npx skills add https://github.com/EffortlessMetrics/demo-swarm --skill policy-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the enforcement of organizational policies (e.g., security, compliance, best practices) within your codebase, eliminating slow, inconsistent, and error-prone manual checks that delay releases and increase risk.

Core Features & Use Cases

  • Policy-as-Code Execution: Reads policy_plan.md to discover and execute configured policy checks using tools like OPA or Conftest.
  • Automated Reporting: Captures raw policy runner output and generates a concise policy_runner_summary.md detailing checks run, passed, failed, and policies that are planned but not auto-executed.
  • SDLC Integration: Designed for seamless use in the "Plan" and "Gate" phases to ensure policy adherence throughout the development lifecycle.
  • Use Case: Before deploying a new feature, automatically run security and compliance policies defined in your policy_plan.md to ensure no critical violations are introduced, providing an immediate verdict on policy adherence.

Quick Start

Execute the policy-runner skill to evaluate all configured policies based on the 'policy_plan.md' file, summarizing the results in 'policy_runner_summary.md'.

Frequently Asked Questions about policy-runner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate security and compliance policy checks in my codebase?

Policy-as-code automation executes security and compliance checks defined in policy_plan.md using tools like OPA and Conftest, running policy evaluations against your code and reporting results without manual intervention or code modification.

What's the difference between policy-as-code and manual compliance reviews?

Policy-as-code eliminates slow, inconsistent manual checks by automatically enforcing organizational policies at defined SDLC phases, providing immediate verdicts on policy adherence and reducing release delays and compliance risk.

Can I integrate policy checks into my deployment pipeline?

Yes, policy-runner is designed for seamless SDLC integration in Plan and Gate phases, automatically executing configured policy checks and generating policy_runner_summary.md before deployment to ensure policy compliance.

Do I need to modify my policies or code when running policy checks?

No, policy-runner reads policy_plan.md to discover and execute checks while writing results to policy_runner_output.log and policy_runner_summary.md, leaving policy files and source code untouched.

What output does policy-runner provide after running checks?

Policy-runner generates policy_runner_summary.md documenting all checks run, passed, failed, and planned-only policies, plus policy_runner_output.log capturing raw policy runner output for detailed review.

How do I configure which policies to enforce?

Policy-runner discovers and executes policies by reading policy_plan.md, supporting both explicit commands like conftest test and opa eval, as well as policy-file entries for automated policy enforcement.