Skip to content

aiskillstore/marketplace / skills/1102tools-dev/acquisition-policy-workflow

acquisition-policy-workflow

Verified

Trigger for: explaining current FAR, DFARS, or agency-supplement text; determining documented acquisition-policy status for an agency and FAR part; comparing codified text, RFO model text, and agency deviations; tracing acquisition rulemaking; finding procurement comment periods; analyzing public comments; refreshing prior policy analysis; or producing an Acquisition Policy Impact Brief. Use published federal sources and supplied policy documents without making legal or procurement-specific applicability determinations. Do not use for clause selection, market research execution, opportunities, pricing, grants, or cooperative agreements.

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-08-24T12:32:25.196Z",
    "slug": "1102tools-dev-acquisition-policy-workflow",
    "source_url": "https://github.com/1102tools-dev/federal-contracting-skills/tree/6c8edf1c45e63acd1bdbb276392924435dde28b3/skills/acquisition-policy-workflow",
    "source_ref": "6c8edf1c45e63acd1bdbb276392924435dde28b3",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "762088427c54da83b451a3e05c099b76085fb8919416b75fea197db2ee1b7a05",
    "tree_hash": "947fc8ad941ac6dab56011e9d35cfa38dbc83a4ed3ffae6ed81eccfd4d028f37",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    },
    "upstream_version_raw": null,
    "upstream_version_normalized": null,
    "upstream_version_source": "none",
    "upstream_version_status": "missing",
    "upstream_commit_sha": "6c8edf1c45e63acd1bdbb276392924435dde28b3"
  },
  "skill": {
    "name": "acquisition-policy-workflow",
    "description": "Research published federal acquisition policy, compare codified and deviation text, trace rulemaking, analyze comments, and create validated Acquisition Policy Impact Briefs.",
    "summary": "Trace federal acquisition policy with dated evidence, clear status boundaries, and validated brief generation.",
    "icon": "📦",
    "author": "1102tools-dev",
    "license": "MIT",
    "category": "research",
    "tags": [
      "federal-acquisition",
      "far",
      "policy-research",
      "rulemaking",
      "compliance"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "filesystem",
      "env_access"
    ]
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "All 40 static findings are false positives caused by safe validation, document formatting, and Markdown patterns. The fixed validator subprocess uses an argument list, while archive handling only checks DOCX structure. No credential access, reconnaissance, obfuscation, prompt injection, or exfiltration intent was found.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "scripts/build_acquisition_policy_brief.py",
            "line_start": 519,
            "line_end": 519
          },
          {
            "file": "SKILL.md",
            "line_start": 19,
            "line_end": 19
          },
          {
            "file": "SKILL.md",
            "line_start": 46,
            "line_end": 46
          },
          {
            "file": "SKILL.md",
            "line_start": 47,
            "line_end": 47
          },
          {
            "file": "SKILL.md",
            "line_start": 53,
            "line_end": 68
          },
          {
            "file": "SKILL.md",
            "line_start": 68,
            "line_end": 100
          },
          {
            "file": "SKILL.md",
            "line_start": 100,
            "line_end": 112
          },
          {
            "file": "SKILL.md",
            "line_start": 112,
            "line_end": 157
          },
          {
            "file": "SKILL.md",
            "line_start": 157,
            "line_end": 158
          },
          {
            "file": "SKILL.md",
            "line_start": 158,
            "line_end": 159
          },
          {
            "file": "SKILL.md",
            "line_start": 159,
            "line_end": 164
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "scripts/validate_acquisition_policy_brief.py",
            "line_start": 11,
            "line_end": 11
          },
          {
            "file": "scripts/validate_acquisition_policy_brief.py",
            "line_start": 97,
            "line_end": 97
          },
          {
            "file": "scripts/validate_acquisition_policy_brief.py",
            "line_start": 170,
            "line_end": 170
          }
        ]
      },
      {
        "factor": "env_access",
        "evidence": [
          {
            "file": "scripts/validate_policy_research_record.py",
            "line_start": 120,
            "line_end": 120
          },
          {
            "file": "scripts/validate_policy_research_record.py",
            "line_start": 128,
            "line_end": 128
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:scripts/build_acquisition_policy_brief.py:519:python-subprocess-run",
        "category": "external_commands",
        "severity": "high",
        "pattern": "Python subprocess.run",
        "file": "scripts/build_acquisition_policy_brief.py",
        "line_start": 519,
        "line_end": 519,
        "snippet": "result = subprocess.run([sys.executable, str(validator), str(args.record)], check=False)"
      },
      {
        "id": "blocker:scripts/build_acquisition_policy_brief.py:116:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/build_acquisition_policy_brief.py",
        "line_start": 116,
        "line_end": 116,
        "snippet": "grid = table._tbl.tblGrid"
      },
      {
        "id": "blocker:scripts/build_acquisition_policy_brief.py:135:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/build_acquisition_policy_brief.py",
        "line_start": 135,
        "line_end": 135,
        "snippet": "relationship_id = paragraph.part.relate_to(url, RT.HYPERLINK, is_external=True)"
      },
      {
        "id": "filesystem:scripts/validate_acquisition_policy_brief.py:11:python-archive-libraries",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Python archive libraries",
        "file": "scripts/validate_acquisition_policy_brief.py",
        "line_start": 11,
        "line_end": 11,
        "snippet": "import zipfile"
      },
      {
        "id": "filesystem:scripts/validate_acquisition_policy_brief.py:97:python-archive-libraries",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Python archive libraries",
        "file": "scripts/validate_acquisition_policy_brief.py",
        "line_start": 97,
        "line_end": 97,
        "snippet": "if not zipfile.is_zipfile(document_path):"
      },
      {
        "id": "filesystem:scripts/validate_acquisition_policy_brief.py:170:python-archive-libraries",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Python archive libraries",
        "file": "scripts/validate_acquisition_policy_brief.py",
        "line_start": 170,
        "line_end": 170,
        "snippet": "except (OSError, ValueError, json.JSONDecodeError, zipfile.BadZipFile) as exc:"
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:80:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_acquisition_policy_brief.py",
        "line_start": 80,
        "line_end": 80,
        "snippet": "failures.append(f\"table {table_index + 1} grid widths do not total 9360 DXA\")"
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:98:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_acquisition_policy_brief.py",
        "line_start": 98,
        "line_end": 98,
        "snippet": "return {\"status\": \"fail\", \"failures\": [\"file is not a valid DOCX ZIP\"]}"
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:132:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_acquisition_policy_brief.py",
        "line_start": 132,
        "line_end": 132,
        "snippet": "for evidence_id in finding.get(\"evidence_ids\", []):"
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:133:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_acquisition_policy_brief.py",
        "line_start": 133,
        "line_end": 133,
        "snippet": "if evidence_id not in text:"
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:136:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_acquisition_policy_brief.py",
        "line_start": 136,
        "line_end": 136,
        "snippet": "policy_id = policy.get(\"id\")"
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:137:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_acquisition_policy_brief.py",
        "line_start": 137,
        "line_end": 137,
        "snippet": "if policy_id and policy_id not in text:"
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:139:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_acquisition_policy_brief.py",
        "line_start": 139,
        "line_end": 139,
        "snippet": "for evidence_id in sorted(evidence_ids):"
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:140:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_acquisition_policy_brief.py",
        "line_start": 140,
        "line_end": 140,
        "snippet": "if evidence_id not in text:"
      },
      {
        "id": "env_access:scripts/validate_policy_research_record.py:120:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "scripts/validate_policy_research_record.py",
        "line_start": 120,
        "line_end": 120,
        "snippet": "\"api_key\","
      },
      {
        "id": "env_access:scripts/validate_policy_research_record.py:128:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "scripts/validate_policy_research_record.py",
        "line_start": 128,
        "line_end": 128,
        "snippet": "\"api_key\","
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:173:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_policy_research_record.py",
        "line_start": 173,
        "line_end": 173,
        "snippet": "return \"is not a valid URL\""
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:174:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_policy_research_record.py",
        "line_start": 174,
        "line_end": 174,
        "snippet": "if parsed.scheme not in {\"http\", \"https\"} or not parsed.hostname:"
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:176:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_policy_research_record.py",
        "line_start": 176,
        "line_end": 176,
        "snippet": "host = parsed.hostname.lower().rstrip(\".\")"
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:233:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_policy_research_record.py",
        "line_start": 233,
        "line_end": 233,
        "snippet": "failures.append(\"scope.as_of_date must be a valid YYYY-MM-DD date\")"
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:243:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_policy_research_record.py",
        "line_start": 243,
        "line_end": 243,
        "snippet": "failures.append(\"scope.procurement_dates values must be empty or valid YYYY-MM-DD dates\")"
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:274:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_policy_research_record.py",
        "line_start": 274,
        "line_end": 274,
        "snippet": "item_id = item.get(\"id\")"
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:276:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_policy_research_record.py",
        "line_start": 276,
        "line_end": 276,
        "snippet": "failures.append(f\"{collection}[{index}].id has an invalid format\")"
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:278:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_policy_research_record.py",
        "line_start": 278,
        "line_end": 278,
        "snippet": "if item_id in ids[collection]:"
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:365:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/validate_policy_research_record.py",
        "line_start": 365,
        "line_end": 365,
        "snippet": "conflict_id = item.get(\"id\")"
      },
      {
        "id": "external_commands:SKILL.md:19:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 19,
        "line_end": 19,
        "snippet": "Explain and trace published federal acquisition policy with an explicit as-of date, source hierarchy"
      },
      {
        "id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 46,
        "line_end": 46,
        "snippet": "12. **Artifact gate:** Generate a `.docx` only after the record and findings are approved. The docum"
      },
      {
        "id": "external_commands:SKILL.md:47:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 47,
        "line_end": 47,
        "snippet": "13. **Unresolved policy conflicts:** When cited sources disagree about a material threshold, status,"
      },
      {
        "id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 53,
        "line_end": 68,
        "snippet": "```text"
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 68,
        "line_end": 100,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:100:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 100,
        "line_end": 112,
        "snippet": "6. Planned chat or `.docx` output."
      },
      {
        "id": "external_commands:SKILL.md:112:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 112,
        "line_end": 157,
        "snippet": "- Python, `python-docx`, and a renderer only when a brief is requested."
      },
      {
        "id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 157,
        "line_end": 158,
        "snippet": "2. Save the record as JSON and run `scripts/validate_policy_research_record.py`."
      },
      {
        "id": "external_commands:SKILL.md:158:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 158,
        "line_end": 159,
        "snippet": "3. Run `scripts/build_acquisition_policy_brief.py <record.json> <output.docx>`."
      },
      {
        "id": "external_commands:SKILL.md:159:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 159,
        "line_end": 164,
        "snippet": "4. Run `scripts/validate_acquisition_policy_brief.py <output.docx> --record <record.json>`."
      },
      {
        "id": "blocker:test.md:7:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "test.md",
        "line_start": 7,
        "line_end": 7,
        "snippet": "The canonical skill passed quick validation, nine-skill repository validation, and 10 deterministic "
      },
      {
        "id": "blocker:testing.md:34:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "testing.md",
        "line_start": 34,
        "line_end": 34,
        "snippet": "- The valid fixture passes record validation and builds a DOCX."
      },
      {
        "id": "blocker:testing.md:35:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "testing.md",
        "line_start": 35,
        "line_end": 35,
        "snippet": "- Unknown evidence references, unsafe query keys, invalid status, operative model text, missing devi"
      },
      {
        "id": "obfuscation:scripts/build_acquisition_policy_brief.py:1:heuristic-multiple-bracket-chains-8-jsfuck-obfus",
        "category": "obfuscation",
        "severity": "high",
        "pattern": "[HEURISTIC] Multiple bracket chains (8) - JSFuck/obfuscation pattern",
        "file": "scripts/build_acquisition_policy_brief.py",
        "line_start": 1,
        "line_end": 1,
        "snippet": "{})}, [])), []))"
      },
      {
        "id": "obfuscation:scripts/validate_policy_research_record.py:1:heuristic-multiple-bracket-chains-10-jsfuck-obfu",
        "category": "obfuscation",
        "severity": "high",
        "pattern": "[HEURISTIC] Multiple bracket chains (10) - JSFuck/obfuscation pattern",
        "file": "scripts/validate_policy_research_record.py",
        "line_start": 1,
        "line_end": 1,
        "snippet": "[])), [])), []))"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:scripts/build_acquisition_policy_brief.py:519:python-subprocess-run",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The subprocess invokes the fixed sibling record validator with the current Python interpreter and an argument list. It does not use a shell or construct executable input."
      },
      {
        "id": "blocker:scripts/build_acquisition_policy_brief.py:116:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This accesses the internal DOCX table grid to set column geometry. It does not inspect the host system."
      },
      {
        "id": "blocker:scripts/build_acquisition_policy_brief.py:135:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This creates a DOCX hyperlink relationship for a supplied evidence URL. It performs no network request or system reconnaissance."
      },
      {
        "id": "filesystem:scripts/validate_acquisition_policy_brief.py:11:python-archive-libraries",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The zipfile import supports structural validation of DOCX files, which are ZIP containers. The script does not extract archive entries."
      },
      {
        "id": "filesystem:scripts/validate_acquisition_policy_brief.py:97:python-archive-libraries",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "zipfile.is_zipfile only verifies that the requested document is a valid ZIP container. It does not write or extract archive content."
      },
      {
        "id": "filesystem:scripts/validate_acquisition_policy_brief.py:170:python-archive-libraries",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This line catches BadZipFile with other expected validation errors. Exception handling does not create an archive security risk."
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:80:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line reports invalid DOCX table widths after inspecting document XML. It does not gather system information."
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:98:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This returns a validation failure for a non-DOCX ZIP input. It contains no reconnaissance behavior."
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:132:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The loop reads evidence identifiers from the supplied research record. It does not inspect system state."
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:133:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The condition checks whether an evidence identifier appears in extracted DOCX text. This is local content validation."
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:136:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line reads a policy item identifier from structured input. It does not query the operating environment."
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:137:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The condition verifies that a policy identifier appears in the generated brief. This is document consistency checking."
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:139:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "Sorting and iterating known evidence identifiers is deterministic document validation. It reveals no system information."
      },
      {
        "id": "blocker:scripts/validate_acquisition_policy_brief.py:140:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This checks generated text for each expected evidence identifier. It is unrelated to host reconnaissance."
      },
      {
        "id": "env_access:scripts/validate_policy_research_record.py:120:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The api_key string is in a denylist of unsafe query parameter names. The script rejects that field and never reads an environment variable or secret."
      },
      {
        "id": "env_access:scripts/validate_policy_research_record.py:128:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The api_key string is a sensitive URL-key marker used to reject credential-bearing URLs. No credential is accessed, stored, or transmitted."
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:173:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This returns an error when URL parsing fails. It performs no host or network discovery."
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:174:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The condition restricts evidence locators to HTTP or HTTPS URLs with hostnames. This is input validation, not reconnaissance."
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:176:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line normalizes the hostname parsed from a supplied URL for subsequent safety checks. It does not resolve or probe the host."
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:233:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This records a schema failure for an invalid as-of date. It does not inspect system time or configuration."
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:243:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This validates procurement date strings in the research record. It contains no system discovery logic."
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:274:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line reads an item identifier from structured record data. It does not access machine identifiers."
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:276:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This emits an error for an invalid record identifier format. It is ordinary schema validation."
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:278:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The condition detects duplicate identifiers within the supplied record. It does not enumerate system resources."
      },
      {
        "id": "blocker:scripts/validate_policy_research_record.py:365:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This reads a conflict identifier from the policy record to enforce conflict reporting rules. It has no reconnaissance function."
      },
      {
        "id": "external_commands:SKILL.md:19:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line uses Markdown backticks around the DOCX extension. It is descriptive prose and cannot execute a shell command."
      },
      {
        "id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks format the DOCX extension in an artifact validation instruction. No Ruby or shell execution syntax is present."
      },
      {
        "id": "external_commands:SKILL.md:47:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks format the documented_conflict status value in policy guidance. This is Markdown, not executable code."
      },
      {
        "id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The detected backticks open a fenced text block containing a user menu. The block has no executable commands."
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The detected backticks close the fenced text menu. Markdown fencing does not invoke Ruby or a shell."
      },
      {
        "id": "external_commands:SKILL.md:100:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks format the DOCX extension in a planned-output list item. The line contains no command execution."
      },
      {
        "id": "external_commands:SKILL.md:112:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks format the python-docx package name in a capability list. They are ordinary Markdown notation."
      },
      {
        "id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The line documents how to run the bundled record validator. The backticks only format a fixed script path and do not execute it automatically."
      },
      {
        "id": "external_commands:SKILL.md:158:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The line documents the expected brief-builder invocation with user-selected local paths. It is workflow guidance, not hidden shell execution."
      },
      {
        "id": "external_commands:SKILL.md:159:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The line documents the bundled DOCX validator invocation. Markdown backticks do not execute the command."
      },
      {
        "id": "blocker:test.md:7:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This line summarizes completed validation tests and generated artifact checks. It performs no system reconnaissance."
      },
      {
        "id": "blocker:testing.md:34:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This line states that a valid fixture passes record validation and builds a DOCX. It is a test expectation with no system reconnaissance behavior."
      },
      {
        "id": "blocker:testing.md:35:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This test requirement lists invalid record conditions that must fail validation. It does not inspect the host system."
      },
      {
        "id": "obfuscation:scripts/build_acquisition_policy_brief.py:1:heuristic-multiple-bracket-chains-8-jsfuck-obfus",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "Line 1 is a standard Python shebang, and the file is readable Python for DOCX generation. Nested comprehensions and indexing triggered the aggregate heuristic, not obfuscation."
      },
      {
        "id": "obfuscation:scripts/validate_policy_research_record.py:1:heuristic-multiple-bracket-chains-10-jsfuck-obfu",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "Line 1 is a standard Python shebang, and the validator source is unobfuscated Python. Repeated structured-data indexing triggered the heuristic without hidden code."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 14,
    "total_lines": 1885,
    "audit_model": "codex",
    "audited_at": "2026-08-24T12:32:25.196Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Trace Federal Acquisition Policy with Evidence",
    "value_statement": "Federal acquisition policy changes across codified rules, deviations, notices, and guidance. This skill produces dated, sourced analysis with explicit status and decision boundaries.",
    "seo_keywords": [
      "federal acquisition policy",
      "FAR research",
      "DFARS analysis",
      "agency deviations",
      "acquisition rulemaking",
      "public comments",
      "policy impact brief",
      "Claude",
      "Codex",
      "Claude Code"
    ],
    "actual_capabilities": [
      "Explains current FAR, DFARS, and agency-supplement text using published federal sources.",
      "Determines documented agency policy status for a specified FAR part and date.",
      "Compares codified text, RFO model text, and agency-issued deviations.",
      "Traces proposed rules, final rules, effective dates, withdrawals, and corrections.",
      "Analyzes defined samples of public comments while preserving coverage limitations.",
      "Builds and validates a DOCX Acquisition Policy Impact Brief from an approved research record."
    ],
    "limitations": [
      "It does not provide legal advice or procurement-specific applicability determinations.",
      "Complete research depends on the required federal MCP servers and their available operations.",
      "It does not select clauses, execute market research, price acquisitions, or pursue opportunities.",
      "Formal briefs require Python, python-docx, LibreOffice, and manual visual review."
    ],
    "use_cases": [
      {
        "title": "Verify Agency Policy Status",
        "description": "Compare codified rules and agency deviations for a defined procurement date and FAR part.",
        "target_user": "Contracting policy analyst"
      },
      {
        "title": "Assess Regulatory Change",
        "description": "Trace a rulemaking timeline and summarize documented operational effects for an industry audience.",
        "target_user": "Industry compliance team"
      },
      {
        "title": "Review Public Comments",
        "description": "Analyze a bounded comment sample with recorded search terms, coverage, exclusions, and limitations.",
        "target_user": "Public-interest researcher"
      }
    ],
    "prompt_templates": [
      {
        "title": "Explain a Current Rule",
        "prompt": "Explain FAR 15.404-1 as of 2026-08-24. Distinguish codified requirements from guidance and cite official sources.",
        "scenario": "Beginner lookup of a specific codified provision"
      },
      {
        "title": "Determine Agency Status",
        "prompt": "Determine documented policy status for [agency], FAR Part [number], as of [date]. Ask for missing procurement dates before retrieval.",
        "scenario": "Agency-specific status review"
      },
      {
        "title": "Compare Policy Layers",
        "prompt": "Compare eCFR text, RFO model text, and [agency] deviation for FAR Part [number]. Preserve scope, effective dates, exclusions, and conflicts.",
        "scenario": "Multi-source deviation analysis"
      },
      {
        "title": "Analyze Comments and Brief",
        "prompt": "Analyze comments for docket [ID] using an approved sample, then prepare a neutral Acquisition Policy Impact Brief with evidence IDs and limitations.",
        "scenario": "Advanced public-comment analysis and formal reporting"
      }
    ],
    "output_examples": [
      {
        "input": "Explain the current FAR rule for a cited provision as of a specified date.",
        "output": [
          "Documented status: Current codified text as of the requested date.",
          "Authority layers: Codified text is separated from later notices and guidance.",
          "Limitations: Procurement-specific applicability remains with authorized officials."
        ]
      },
      {
        "input": "Compare an agency deviation with RFO model text and the eCFR baseline.",
        "output": [
          "Comparison: Each source is listed with scope, effective date, and exclusions.",
          "Status: Model text is not treated as operative without agency adoption.",
          "Conflict handling: Material disagreements remain documented and unresolved."
        ]
      },
      {
        "input": "Prepare an Acquisition Policy Impact Brief from approved findings.",
        "output": "A validated DOCX brief presents the executive summary, status, timeline, impacts, evidence register, limitations, and reserved determinations."
      }
    ],
    "best_practices": [
      "Provide the exact question, as-of date, agency, FAR part, and relevant procurement dates.",
      "Approve the source plan before multi-source analysis or formal brief generation.",
      "Review evidence, conflicts, limitations, and status classifications before approving a brief."
    ],
    "anti_patterns": [
      "Do not send private, proprietary, classified, credential-bearing, or source-selection information to public research tools.",
      "Do not treat model deviations, proposed rules, or future-effective rules as current agency policy.",
      "Do not use sampled public comments as authority, consensus, or a representative survey."
    ],
    "faq": [
      {
        "question": "Which acquisition sources does this skill use?",
        "answer": "It uses eCFR, Federal Register, Regulations.gov, and Acquisition.gov capabilities when required by the selected mode."
      },
      {
        "question": "Can it determine which clause applies to my procurement?",
        "answer": "No. Clause selection and procurement-specific applicability determinations remain outside this skill."
      },
      {
        "question": "Can it analyze an agency deviation?",
        "answer": "Yes. It preserves the deviation scope, effective date, exclusions, transition rules, and supersession language."
      },
      {
        "question": "Does it analyze public comments?",
        "answer": "Yes. It records search terms, sample methods, reviewed counts, coverage, exclusions, and limitations."
      },
      {
        "question": "Can it create a formal report?",
        "answer": "Yes. It can generate a validated DOCX Acquisition Policy Impact Brief after the research record and findings receive approval."
      },
      {
        "question": "What happens when required tools are unavailable?",
        "answer": "It reports the missing capability and offers a narrower product supported by available official sources."
      }
    ]
  },
  "file_structure": [
    {
      "name": "agents",
      "type": "dir",
      "path": "agents",
      "children": [
        {
          "name": "openai.yaml",
          "type": "file",
          "path": "agents/openai.yaml",
          "lines": 5
        }
      ]
    },
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "document-intake.md",
          "type": "file",
          "path": "references/document-intake.md",
          "lines": 32
        },
        {
          "name": "evidence-contract.md",
          "type": "file",
          "path": "references/evidence-contract.md",
          "lines": 84
        },
        {
          "name": "launch-menu-and-framing.md",
          "type": "file",
          "path": "references/launch-menu-and-framing.md",
          "lines": 58
        },
        {
          "name": "report-specification.md",
          "type": "file",
          "path": "references/report-specification.md",
          "lines": 41
        },
        {
          "name": "runtime-adaptation.md",
          "type": "file",
          "path": "references/runtime-adaptation.md",
          "lines": 25
        },
        {
          "name": "source-routing.md",
          "type": "file",
          "path": "references/source-routing.md",
          "lines": 65
        },
        {
          "name": "status-and-decision-boundaries.md",
          "type": "file",
          "path": "references/status-and-decision-boundaries.md",
          "lines": 61
        }
      ]
    },
    {
      "name": "scripts",
      "type": "dir",
      "path": "scripts",
      "children": [
        {
          "name": "build_acquisition_policy_brief.py",
          "type": "file",
          "path": "scripts/build_acquisition_policy_brief.py",
          "lines": 533
        },
        {
          "name": "validate_acquisition_policy_brief.py",
          "type": "file",
          "path": "scripts/validate_acquisition_policy_brief.py",
          "lines": 186
        },
        {
          "name": "validate_policy_research_record.py",
          "type": "file",
          "path": "scripts/validate_policy_research_record.py",
          "lines": 555
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 179
    },
    {
      "name": "test.md",
      "type": "file",
      "path": "test.md",
      "lines": 18
    },
    {
      "name": "testing.md",
      "type": "file",
      "path": "testing.md",
      "lines": 43
    }
  ]
}
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall