reference-controls-enricher

Link CISO Assistant framework requirements to reference control URNs and patch framework YAML.

4.4k|825|Updated Sep 20, 2023
One-click install
npx skills add https://github.com/intuitem/ciso-assistant-community --skill reference-controls-enricher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reference-controls-enricher
Source: https://github.com/intuitem/ciso-assistant-community/tree/main/.claude/skills/reference-controls-enricher
Command: npx skills add https://github.com/intuitem/ciso-assistant-community --skill reference-controls-enricher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, openpyxl, and includes scripts (resource) components.

What problem does it solve?

Manually mapping every assessable requirement in a CISO Assistant framework YAML to the central doc-pol key reference controls library is slow, error-prone, and hard to audit. This Skill walks each requirement, proposes 1–5 reference control URNs with confidence scores and rationales, and applies the enrichment in place.

Core Features & Use Cases

  • Requirement-to-control mapping: Parses the framework YAML and the key-reference-controls library, then reasons section-by-section using a prefix-family affinity map (pol, proc, doc, tech, phys, train) to propose tight URN linkages.
  • Reviewable outputs: Generates a color-coded xlsx review sheet (flagging LOW-confidence and ZERO-coverage rows) plus a coverage report with per-section percentages, URN histograms, and confidence distributions.
  • Safe in-place patching: Appends URNs to each requirement's reference_controls field (deduplicating, never replacing), adds the doc-pol dependency, validates target URNs against the library, and optionally bumps the framework version.
  • Use Case: You are contributing a new compliance framework to backend/library/libraries/ and want every requirement wired to applied-control suggestions. Run the enrichment, review the xlsx with stakeholders, then apply the patch and validate with storelibraries.

Quick Start

Add reference controls from the doc-pol library to the framework at backend/library/libraries/my-framework.yaml and produce a review spreadsheet before applying changes.

Frequently Asked Questions about reference-controls-enricher

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

FAQPage Schema
How do I add reference controls to a CISO Assistant framework YAML?

Parse the framework and the key-reference-controls library with the provided scripts, emit one JSONL verdict per requirement listing target doc-pol URNs, then run apply_enrichment.py to append the URNs in place. The script also adds the doc-pol dependency and can bump the version.

How do I review control mappings before applying them to a framework?

Run write_review.py with the parsed framework, parsed controls, and verdicts file to generate a color-coded xlsx. Rows are flagged LOW when confidence is below 5 and ZERO when a requirement has no linked URNs, so reviewers can focus on borderline cases.

Does the enrichment overwrite existing reference_controls on requirements?

No, apply_enrichment.py only appends new URNs and deduplicates against existing entries. However, it cannot remove URNs from a prior apply, so revert the file with git checkout before re-running with edited verdicts.

What are the limitations of this enrichment approach for large frameworks?

Frameworks with more than 500 assessable items overflow the conversation context, since the AI reasons over every requirement directly. For those cases, chunk the run across sessions or adapt the mapping scripts for offline batch use.

Why does my enriched framework fail to load with storelibraries?

Load failures usually come from unresolved URNs, either typos in target URNs or a missing doc-pol dependency. apply_enrichment.py validates target URNs against the controls library and adds the dependency automatically, so hand-edited verdicts are the usual culprit.