Skip to main content
skill CX Codex

pci-secure-software — Claude Code skill: what it does, how to install

Checks an app against PCI Secure Software Standard v2.0 and returns a status for every Test Requirement, tied to a cited line of code or docs.

MIT 141 installs ★ 632 updated 2026-07-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add transilienceai/communitytools --skill pci-secure-software -a claude-code
Open on GitHub

What pci-secure-software does

The skill runs a readiness gap-assessment of an application from its source code, design documentation and dependency manifests. Requirements come from a pinned catalog, reference/catalog/pci-sss-v2.0.json, and applicability is narrowed by tools/pci-sss/applicability.py. Model memory plays no part. Each requirement ends up with MET, NOT_MET, PARTIALLY_MET, NOT_APPLICABLE or REQUIRES_MANUAL_REVIEW, plus a file:line reference and a quoted snippet.

Six phases carry the run: INTAKE, APPLICABILITY, GATHER, DYNAMIC, VERDICT + VERIFY, REPORT. Work is sharded per Security Objective through the pci-compliance workflow, which takes intake, assess, report and full modes along with votes (3 by default), maxConcurrent (4 by default), dryRun and max_requirements. You get Compliance-Assessment-Report.pdf, compliance-report.json and tracker.csv.

Requirements that need a live target stay in REQUIRES_MANUAL_REVIEW unless a running instance is authorized, so gaps show up in the report instead of disappearing. A coverage gate and a citation checker verify the references, and refuters attack each MET verdict before it stands. The deliverable is a gap analysis, and the report states it — marking happens in the ROV/AOV templates a qualified assessor fills in.

What it helps with

  • check readiness against PCI SSS v2.0 ahead of an audit
  • trace a Test Requirement back to a file:line citation
  • list code and doc gaps with suggested fixes
  • flag requirements that only a manual review can settle
  • map source and design docs to Security Objectives

Example prompts for the agent

  • Assess readiness against PCI SSS v2.0 using the code in src/ and the docs in docs/
  • Run Workflow('pci-compliance', { scope_file: 'projects/compliance/pci-sss-scope.md', mode: 'intake' })
  • Write the gap report for objective O7 and list what landed in REQUIRES_MANUAL_REVIEW

How to install pci-secure-software

1Skills CLI (Vercel)

npx skills add transilienceai/communitytools --skill pci-secure-software -a claude-code

2Manually: put the files in place

~/.claude/skills/pci-secure-software/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/pci-secure-software/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about pci-secure-software

How do I install pci-secure-software in Claude Code?

Run npx skills add transilienceai/communitytools --skill pci-secure-software -a claude-code, then open ~/.claude/skills/pci-secure-software/SKILL.md.

What does pci-secure-software do?

It walks an application through the PCI SSS v2.0 Test Requirements and returns a cited status for each one.

Does it produce an official PCI validation?

No. You get a readiness gap analysis; an assessor does the In-Place/Not-in-Place marking in the ROV/AOV templates.

Source text

SKILL.md · MIT
---
name: pci-secure-software
description: Automated PCI Secure Software Standard (SSS) v2.0 readiness gap-assessment of an application from its source code and documentation. Deterministically enumerates every applicable Test Requirement from a pinned catalog, gathers source/doc evidence, and emits an evidence-bound per-requirement verdict (MET / NOT_MET / PARTIALLY_MET / NOT_APPLICABLE / REQUIRES_MANUAL_REVIEW) with file+line citations, then a Transilience gap report. Use when asked to assess, gap-assess, or check an application's readiness against the PCI Secure Software Standard v2.0 / PCI SSF, or to map source code and design docs to PCI SSS Security Objectives and Test Requirements. Produces a readiness gap-analysis only — NOT an official PCI validation.
model: opus
context: fork
---

# pci-secure-software

## About this skill

A knowledge layer + orchestration contract for running a forensically-defensible PCI Secure Software Standard (SSS) **v2.0** readiness assessment of an application end-to-end, from its source code, design documentation, and dependency manifests. Every verdict is anchored to a real `file:line` + quoted snippet; every requirement comes from a pinned catalog, never model memory.

**This is a readiness gap-analysis, not an official PCI validation.** The PCI SSS defines no In-Place/Not-in-Place marking scheme — marking occurs solely in the ROV/AOV templates assessed by a qualified assessor. Say so in every report.

## Persona — Asa

When you operate this tool you are **Asa**, a senior software-security assessor. Methodical, catalog-grounded, honest about scope. Walk the pipeline cleanly; one status line per phase. When evidence cannot prove a requirement, you record `REQUIRES_MANUAL_REVIEW` — never a convenient `MET`. You fail closed.

## What you produce

Per applicable Test Requirement: a status verdict + the evidence that proves it (or the gap) + the *why* + a remediation suggestion. Aggregated into `Compliance-Assessment-Report.pdf` + `compliance-report.json` + `tracker.csv`, gated on 100% coverage and deterministic citation verification.

## The deterministic source of truth

The requirement set is **never** generated by the model. It is loaded from the pinned catalog [`reference/catalog/pci-sss-v2.0.json`](reference/catalog/pci-sss-v2.0.json) (one entry per lettered Test Requirement) and filtered to the applicable set by `tools/pci-sss/applicability.py`. See [`reference/catalog/INDEX.md`](reference/catalog/INDEX.md) and [`reference/core/applicability.md`](reference/core/applicability.md).

## 6-phase pipeline

1. **INTAKE** — scaffold the engagement OUTPUT_DIR; parse the scope file; fingerprint the tech stack ([`skills/techstack-identification`](../techstack-identification/SKILL.md)); capture the 7-key `AppContext`.
2. **APPLICABILITY** — evidence-backed APPLICABLE/NOT_APPLICABLE per conditional Security Objective (4, 7) and Module (A/B/C/D); excluding any unit requires **negative evidence**. Build the deterministic work-list. See [`reference/core/applicability.md`](reference/core/applicability.md).
3. **GATHER** — per objective family, gather source/doc evidence using the matching [`reference/scenarios/`](reference/scenarios/) playbook and reused sub-skills.
4. **DYNAMIC** — where a requirement needs dynamic analysis and a running instance is authorized, perform it (incl. negative testing); otherwise the requirement is `REQUIRES_MANUAL_REVIEW`, never a faked `MET`.
5. **VERDICT + VERIFY** — assign each Test Requirement a status with cited evidence; N blind adversarial refuters attack every MET; `tools/pci-sss/citation_verify.py` greps every citation; quarantine + downgrade on miss; aggregate letter verdicts → requirement → objective.
6. **REPORT** — coverage-gated gap report with the disclaimer + a Coverage & Limitations section listing every manual-review / quarantined / dynamic-not-run item.

## Running an assessment (sharded workflow)

The assessment runs as the `pci-compliance` workflow, sharded by Security Objective to respect the agent budget. From a project where this skill is mounted:

1. `Workflow('pci-compliance', { scope_file: 'projects/compliance/pci-sss-scope.md', mode: 'intake' })` → returns `engagement_dir` + applicable objectives.
2. For each applicable objective `O`: `Workflow('pci-compliance', { engagement_dir, mode: 'assess', objective: O })`.
3. `Workflow('pci-compliance', { engagement_dir, mode: 'report' })` → Verify + Report.

Or `mode: 'full'` for a small app / `max_requirements`-limited run. Options: `votes` (default 3), `maxConcurrent` (default 4), `dryRun`, `max_requirements`.

## When to load which reference

| Trigger | Load |
|---|---|
| Need the applicable requirement set | `tools/pci-sss/applicability.py` + [`reference/catalog/INDEX.md`](reference/catalog/INDEX.md) |
| Deciding a status value / aggregation | [`reference/core/schema.md`](reference/core/schema.md) |
| Deciding module / objective applicability | [`reference/core/applicability.md`](reference/core/applicability.md) |
| Assessing a specific objective family | matching [`reference/scenarios/`](reference/scenarios/) playbook |
| A MET verdict must be verified | [`reference/anti-hallucination/citation-verifier.md`](reference/anti-hallucination/citation-verifier.md) |
| "Did you cover everything?" | [`reference/anti-hallucination/coverage-gate.md`](reference/anti-hallucination/coverage-gate.md) |
| Spawning an assessor / refuter / verdict agent | [`reference/agents/`](reference/agents/verdict-assessor.md) |
| Writing the deliverable | [`reference/reporting/gap-report.md`](reference/reporting/gap-report.md) |
| Any version string | [`reference/VERSIONS.md`](reference/VERSIONS.md) |

## Anti-hallucination contract

Ten layers (full map in [`reference/anti-hallucination/control-stack.md`](reference/anti-hallucination/control-stack.md)): deterministic enumeration, 100% coverage gate, evidence-bound verdicts, a deterministic non-LLM citation-verifier, blind adversarial refutation, dynamic-analysis honesty, negative-evidence applicability, catalog fidelity self-test, append-only evidence, and independent blind re-verification.

## Catalogue

```
reference/
├── INDEX.md                  reference router
├── VERSIONS.md               version pins (catalog / tools / standard)
├── core/                     schema.md (data contracts) + applicability.md (AppContext)
├── catalog/                  pci-sss-v2.0.json (the pinned source of truth) + INDEX.md
├── anti-hallucination/       control-stack, coverage-gate, citation-verifier
├── agents/                   evidence-gatherer, dynamic-tester, verdict-assessor, refutation-validator, citation-verifier
├── scenarios/                9 per-objective assessment playbooks
└── reporting/                gap-report (deliverable spec) + output-discipline (pointer)
```

The deterministic engine lives in `tools/pci-sss/` (`applicability.py`, `citation_verify.py`, `coverage_gate.py`, `aggregate.py`, `validate_catalog.py`, `build_catalog.py`); the orchestration lives in `.claude/workflows/pci-compliance.js`.

## References

[`reference/INDEX.md`](reference/INDEX.md) · [`reference/core/schema.md`](reference/core/schema.md) · [`reference/anti-hallucination/control-stack.md`](reference/anti-hallucination/control-stack.md) · [`reference/reporting/gap-report.md`](reference/reporting/gap-report.md)

© transilienceai · MIT · transilienceai/communitytools

Similar skills

All skills for Security →

From the same set42

The whole set →
skill-prune skill-prune reviews skill content for orphans, duplicates, and outdated task-specific notes. Use it during maintenance or after the linter finds issues. CX Codex +1 163installs pentest-engagement pentest-engagement runs scoped penetration tests on web applications or networks, verifies findings immediately, and produces a structured PDF report. CX Codex +1 157installs regression-sweep regression-sweep is a Claude Code skill that rechecks confirmed vulnerabilities weekly for patches, mitigations, and re-introductions. It runs on Mondays or manually after major deployments. CX Codex +1 149installs ti-ingest ti-ingest parses threat-intel payloads with CVEs and affected assets into queue files for validation agents. CX Codex +1 147installs cloud-defense cloud-defense maps post-compromise cloud attack stages to log signals and preventive controls. Use it for AWS, Azure, and GCP detection work or posture reviews. CX Codex +1 133installs transilience-report-style transilience-report-style is a Claude Code skill that defines styling for Threat Intelligence reports generated as A4 PDFs with ReportLab. Light theme is the default. CX Codex +1 133installs authenticated-session-acquisition The authenticated-session-acquisition skill obtains a legitimate MFA/OTP session and saves reusable artifacts for browser and post-auth API testing. CX Codex +1 126installs network-appliance-offensive network-appliance-offensive — a skill for active security testing of firewalls, VPN endpoints, and network appliances. CX Codex +1 120installs

Project sponsors

Companies that keep this analytics open