aiskillstore/marketplace / skills/1102tools-dev/ot-project-description-builder
ot-project-description-builder
VerifiedTrigger for: OT project description, OTA scope, Research OT under 10 U.S.C. 4021, Prototype OT under 10 U.S.C. 4022, follow-on production scope under 10 U.S.C. 4022(f), milestone-based project scope, prototype objective, phase or go/no-go structure, BAA white-paper conversion, SOO conversion, transition planning, or scope reduction before OT cost analysis. Produce a milestone-based .docx plus a separate chat-only handoff to OT Cost Analysis. Use TRL only when the project supports it. Never place cost estimates, funding profiles, contribution calculations, prices, or skill-routing content in the document. Do NOT use for a FAR SOW/PWS, OT cost analysis, IGCE, agreement terms and conditions, or an Agreements Officer's authority, participant-status, successful-completion, or follow-on determination.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.4 KB |
| agents/openai.yaml | config | 266 B |
| references/authority-and-scope-rules.md | markdown | 4.6 KB |
| references/document-specification.md | markdown | 5.1 KB |
| references/handoff-specification.md | markdown | 2.1 KB |
| references/question-blocks.md | markdown | 3.3 KB |
| references/runtime-adaptation.md | markdown | 1.7 KB |
| references/validation-gates.md | markdown | 2.5 KB |
| scripts/validate_docx.py | script | 10.7 KB |
| skill-report.json | config | 36.5 KB |
| test.md | markdown | 4.7 KB |
| testing.md | markdown | 11.7 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-08-24T13:04:48.163Z",
"slug": "1102tools-dev-ot-project-description-builder",
"source_url": "https://github.com/1102tools-dev/federal-contracting-skills/tree/6c8edf1c45e63acd1bdbb276392924435dde28b3/skills/ot-project-description-builder",
"source_ref": "6c8edf1c45e63acd1bdbb276392924435dde28b3",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "a45181d65244452806d79ce8d7d613ca2a7b22e8e12fd133b7a918292ddc1c6c",
"tree_hash": "4f04541c9900f1ed5e78c6130f4697617df2de5fb6db123483a3ba1e6f2f6aa8",
"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": "ot-project-description-builder",
"description": "Build and validate milestone-based DOCX project descriptions for Research, Prototype, and follow-on production Other Transactions. The skill separates technical scope from cost analysis and preserves required authority decisions.",
"summary": "Create structured, validated OT project descriptions with milestone and authority approval gates.",
"icon": "📦",
"author": "1102tools-dev",
"license": "MIT",
"category": "documentation",
"tags": [
"other-transactions",
"project-description",
"milestones",
"federal-contracting",
"docx"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"filesystem",
"external_commands"
]
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "All 33 static findings are false positives. Archive access only validates local DOCX files, and reported command patterns are Markdown or a fixed local validator call. No malicious intent or prompt injection was found.",
"remediation": [],
"risk_factor_evidence": [
{
"factor": "filesystem",
"evidence": [
{
"file": "scripts/validate_docx.py",
"line_start": 10,
"line_end": 10
},
{
"file": "scripts/validate_docx.py",
"line_start": 85,
"line_end": 85
},
{
"file": "scripts/validate_docx.py",
"line_start": 186,
"line_end": 186
},
{
"file": "scripts/validate_docx.py",
"line_start": 188,
"line_end": 188
},
{
"file": "scripts/validate_docx.py",
"line_start": 194,
"line_end": 194
},
{
"file": "scripts/validate_docx.py",
"line_start": 236,
"line_end": 236
}
]
},
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 21,
"line_end": 21
},
{
"file": "SKILL.md",
"line_start": 25,
"line_end": 25
},
{
"file": "SKILL.md",
"line_start": 26,
"line_end": 26
},
{
"file": "SKILL.md",
"line_start": 36,
"line_end": 36
},
{
"file": "SKILL.md",
"line_start": 48,
"line_end": 48
},
{
"file": "SKILL.md",
"line_start": 52,
"line_end": 52
},
{
"file": "SKILL.md",
"line_start": 58,
"line_end": 58
},
{
"file": "SKILL.md",
"line_start": 84,
"line_end": 84
},
{
"file": "SKILL.md",
"line_start": 111,
"line_end": 111
},
{
"file": "SKILL.md",
"line_start": 113,
"line_end": 113
},
{
"file": "SKILL.md",
"line_start": 138,
"line_end": 138
},
{
"file": "SKILL.md",
"line_start": 142,
"line_end": 142
},
{
"file": "SKILL.md",
"line_start": 143,
"line_end": 143
},
{
"file": "SKILL.md",
"line_start": 147,
"line_end": 147
},
{
"file": "SKILL.md",
"line_start": 148,
"line_end": 148
},
{
"file": "SKILL.md",
"line_start": 149,
"line_end": 149
}
]
}
],
"static_findings": [
{
"id": "blocker:references/authority-and-scope-rules.md:23:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/authority-and-scope-rules.md",
"line_start": 23,
"line_end": 23,
"snippet": "| C | At least one-third of total project cost is paid from non-Federal sources | Record the approve"
},
{
"id": "blocker:references/document-specification.md:102:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/document-specification.md",
"line_start": 102,
"line_end": 102,
"snippet": "- Avoid CLIN, QASP, AQL, option-year, task-order, and FAR-clause language."
},
{
"id": "blocker:references/question-blocks.md:39:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/question-blocks.md",
"line_start": 39,
"line_end": 39,
"snippet": "Each completion criterion must be specific, measurable, testable, and capable of an objective pass o"
},
{
"id": "blocker:references/question-blocks.md:50:network-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "Network reconnaissance",
"file": "references/question-blocks.md",
"line_start": 50,
"line_end": 51,
"snippet": "- Key roles and substitution process"
},
{
"id": "filesystem:scripts/validate_docx.py:10:python-archive-libraries",
"category": "filesystem",
"severity": "medium",
"pattern": "Python archive libraries",
"file": "scripts/validate_docx.py",
"line_start": 10,
"line_end": 10,
"snippet": "import zipfile"
},
{
"id": "filesystem:scripts/validate_docx.py:85:python-archive-libraries",
"category": "filesystem",
"severity": "medium",
"pattern": "Python archive libraries",
"file": "scripts/validate_docx.py",
"line_start": 85,
"line_end": 85,
"snippet": "with zipfile.ZipFile(path) as archive:"
},
{
"id": "filesystem:scripts/validate_docx.py:186:python-archive-libraries",
"category": "filesystem",
"severity": "medium",
"pattern": "Python archive libraries",
"file": "scripts/validate_docx.py",
"line_start": 186,
"line_end": 186,
"snippet": "if not zipfile.is_zipfile(path):"
},
{
"id": "filesystem:scripts/validate_docx.py:188:python-archive-libraries",
"category": "filesystem",
"severity": "medium",
"pattern": "Python archive libraries",
"file": "scripts/validate_docx.py",
"line_start": 188,
"line_end": 188,
"snippet": "with zipfile.ZipFile(path) as archive:"
},
{
"id": "filesystem:scripts/validate_docx.py:194:python-archive-libraries",
"category": "filesystem",
"severity": "medium",
"pattern": "Python archive libraries",
"file": "scripts/validate_docx.py",
"line_start": 194,
"line_end": 194,
"snippet": "except (OSError, ValueError, zipfile.BadZipFile) as exc:"
},
{
"id": "filesystem:scripts/validate_docx.py:236:python-archive-libraries",
"category": "filesystem",
"severity": "medium",
"pattern": "Python archive libraries",
"file": "scripts/validate_docx.py",
"line_start": 236,
"line_end": 236,
"snippet": "except (KeyError, OSError, zipfile.BadZipFile) as exc:"
},
{
"id": "blocker:scripts/validate_docx.py:187:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "scripts/validate_docx.py",
"line_start": 187,
"line_end": 187,
"snippet": "return {\"status\": \"fail\", \"failures\": [\"file is not a valid DOCX ZIP\"]}"
},
{
"id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 21,
"line_end": 21,
"snippet": "Create a milestone-based `.docx` project description for a Research OT under 10 U.S.C. 4021, Prototy"
},
{
"id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 25,
"line_end": 25,
"snippet": "1. One project-description `.docx` suitable for the agreement file. It contains no cost estimate, sh"
},
{
"id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 26,
"line_end": 26,
"snippet": "2. One `MILESTONE HANDOFF TABLE` in chat after document validation. It is an internal workpaper for "
},
{
"id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 36,
"line_end": 36,
"snippet": "- [document-specification.md](references/document-specification.md) in full before building the `.do"
},
{
"id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 48,
"line_end": 48,
"snippet": "6. **Milestones precede prose:** Present the derived phase and milestone structure, including comple"
},
{
"id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 52,
"line_end": 52,
"snippet": "10. **Every placeholder closes:** Each `[TBD]` must name an owner, trigger, and disposition method i"
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 58,
"line_end": 58,
"snippet": "2. Require a `.docx` authoring path, Python 3.10 or later with `python-docx` for the bundled validat"
},
{
"id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 84,
"line_end": 84,
"snippet": "- Approved contribution arrangement and source, or `PENDING`"
},
{
"id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 111,
"line_end": 111,
"snippet": "`Milestone ID | Phase | Objective | Estimated Duration | Deliverables | Completion Evidence | Timing"
},
{
"id": "external_commands:SKILL.md:113:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 113,
"line_end": 113,
"snippet": "Payment Type remains `PENDING` unless supplied. Do not infer Fixed, Cost-Type, or Mixed from milesto"
},
{
"id": "external_commands:SKILL.md:138:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 138,
"line_end": 138,
"snippet": "8. Save only the project-description `.docx` as the document artifact."
},
{
"id": "external_commands:SKILL.md:142:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 142,
"line_end": 142,
"snippet": "1. Run `scripts/validate_docx.py <document> --json`."
},
{
"id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 143,
"line_end": 143,
"snippet": "2. Render the `.docx` to page images with the available document renderer."
},
{
"id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 147,
"line_end": 147,
"snippet": "6. Read [handoff-specification.md](references/handoff-specification.md) and emit the approved milest"
},
{
"id": "external_commands:SKILL.md:148:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 148,
"line_end": 148,
"snippet": "7. Report unresolved `[TBD]` items, the source and date of authority facts, and any validation layer"
},
{
"id": "external_commands:SKILL.md:149:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 149,
"line_end": 149,
"snippet": "8. If the document contains a dynamic TOC, tell the user: `Open the document in Word, press Ctrl+A ("
},
{
"id": "blocker:test.md:20:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "test.md",
"line_start": 20,
"line_end": 20,
"snippet": "- The TOC remained a valid dynamic field with a placeholder in LibreOffice. Microsoft Word was not r"
},
{
"id": "blocker:testing.md:67:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "testing.md",
"line_start": 67,
"line_end": 67,
"snippet": "- **Test 4 (BAA conversion, consortium, path D, software, late TRL 5-7):** Every Group 2 patch that "
},
{
"id": "blocker:testing.md:68:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "testing.md",
"line_start": 68,
"line_end": 68,
"snippet": "- **Test 5 (Research OT, traditional prime, 30 months):** Skill correctly identified that 10 USC 402"
},
{
"id": "blocker:testing.md:84:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "testing.md",
"line_start": 84,
"line_end": 84,
"snippet": "Users in these contexts should expect to validate outputs more carefully and may encounter edge case"
},
{
"id": "blocker:testing.md:92:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "testing.md",
"line_start": 92,
"line_end": 92,
"snippet": "1. Did each patch under test fire correctly?"
},
{
"id": "blocker:testing.md:93:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "testing.md",
"line_start": 93,
"line_end": 93,
"snippet": "2. Did the output surface any new structural gap not covered by existing patches?"
}
],
"finding_verdicts": [
{
"id": "blocker:references/authority-and-scope-rules.md:23:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line is a legal requirements table describing non-Federal project cost contributions. It performs no system discovery or reconnaissance."
},
{
"id": "blocker:references/document-specification.md:102:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line prohibits FAR-oriented terminology in the generated document. It neither inspects the host system nor gathers system information."
},
{
"id": "blocker:references/question-blocks.md:39:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line defines measurable milestone completion criteria. It contains no system access, discovery, or reconnaissance behavior."
},
{
"id": "blocker:references/question-blocks.md:50:network-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The surrounding list requests project roles, locations, supplied resources, and security boundaries from the user. It does not scan or query a network."
},
{
"id": "filesystem:scripts/validate_docx.py:10:python-archive-libraries",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The zipfile import supports DOCX structure validation because DOCX files are ZIP containers. Importing the standard library does not itself access or alter files."
},
{
"id": "filesystem:scripts/validate_docx.py:85:python-archive-libraries",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The validator opens the explicitly supplied DOCX read-only to inspect document and settings XML. It does not extract entries, write files, or traverse archive paths."
},
{
"id": "filesystem:scripts/validate_docx.py:186:python-archive-libraries",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "is_zipfile only verifies that the user-selected document has a ZIP signature. This is a normal format check before DOCX parsing."
},
{
"id": "filesystem:scripts/validate_docx.py:188:python-archive-libraries",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The archive is opened read-only and only member names are collected to verify required DOCX parts. No archive content is extracted to the filesystem."
},
{
"id": "filesystem:scripts/validate_docx.py:194:python-archive-libraries",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "This line catches malformed archive and file errors and returns a validation failure. Exception handling does not introduce filesystem risk."
},
{
"id": "filesystem:scripts/validate_docx.py:236:python-archive-libraries",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "This exception handler safely reports missing or malformed DOCX XML parts during TOC checks. It performs no additional file operation."
},
{
"id": "blocker:scripts/validate_docx.py:187:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line returns a fixed error when the selected input is not a DOCX ZIP. It does not disclose host details or perform reconnaissance."
},
{
"id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "Backticks format the .docx extension as inline Markdown. There is no Ruby expression, shell substitution, or executable command."
},
{
"id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "Backticks format the .docx artifact name in prose. The line describes output boundaries and executes nothing."
},
{
"id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "Backticks identify a named chat table using Markdown. The text contains no shell or Ruby execution syntax."
},
{
"id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line is a Markdown link and formats .docx inline. It directs the agent to read a bundled reference, not execute a command."
},
{
"id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line is prose requiring milestone approval before document generation. It contains no backtick execution or external command."
},
{
"id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "Backticks format the literal placeholder [TBD]. No code or command is evaluated."
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Backticks identify file formats and the python-docx package as prerequisites. The line does not execute a package manager or shell."
},
{
"id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "Backticks format the literal status PENDING in a user-input checklist. There is no executable content."
},
{
"id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The backtick-delimited text is a table header specification. It is document content, not Ruby or shell code."
},
{
"id": "external_commands:SKILL.md:113:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "Backticks format the literal PENDING value. The line defines a business rule and invokes no external process."
},
{
"id": "external_commands:SKILL.md:138:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line instructs the agent to save one DOCX artifact, with the extension formatted in Markdown. It contains no command execution."
},
{
"id": "external_commands:SKILL.md:142:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "This is a fixed invocation of the bundled local DOCX validator with a user-selected document path. Markdown backticks triggered the Ruby pattern, but no Ruby evaluation or untrusted command construction is present."
},
{
"id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The line requests rendering through an available document renderer and formats .docx in Markdown. It provides no shell command or attacker-controlled executable."
},
{
"id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line links a bundled specification and formats .docx inline. It directs document workflow behavior without executing an external command."
},
{
"id": "external_commands:SKILL.md:148:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "Backticks mark the literal [TBD] placeholder. The instruction reports unresolved content and does not invoke a shell."
},
{
"id": "external_commands:SKILL.md:149:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The backtick text is a user-facing Microsoft Word keyboard instruction. It is not executable shell or Ruby syntax."
},
{
"id": "blocker:test.md:20:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line records that LibreOffice rendering did not prove Microsoft Word behavior. This is test provenance, not system reconnaissance."
},
{
"id": "blocker:testing.md:67:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line summarizes a regression test and document-output behavior. It performs no host inspection or reconnaissance."
},
{
"id": "blocker:testing.md:68:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line documents expected legal and milestone behavior from a test run. It contains no system-discovery operation."
},
{
"id": "blocker:testing.md:84:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line advises users to validate outputs in untested contexts. It does not request or collect system information."
},
{
"id": "blocker:testing.md:92:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line is an evaluator question about whether a software patch activated. It does not scan the system."
},
{
"id": "blocker:testing.md:93:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line asks whether test output revealed a structural coverage gap. It is quality evaluation, not reconnaissance."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 11,
"total_lines": 1000,
"audit_model": "codex",
"audited_at": "2026-08-24T13:04:48.163Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Build Milestone-Based OT Project Descriptions",
"value_statement": "OT teams need clear technical scope without unsupported authority or pricing conclusions. This skill builds validated DOCX descriptions and a separate cost-analysis handoff.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"Other Transaction project description",
"Prototype OT scope",
"Research OT documentation",
"milestone schedule",
"federal contracting",
"DOCX validation",
"OT cost analysis handoff"
],
"actual_capabilities": [
"Builds milestone-based project descriptions for Research, Prototype, and follow-on production Other Transactions.",
"Converts white papers, SOOs, SOWs, and draft descriptions into OT-focused technical scope.",
"Creates phased milestones with deliverables, completion evidence, sequence, and pending payment types.",
"Separates project-description content from pricing, funding, contribution calculations, and cost-analysis routing.",
"Validates DOCX structure, required sections, tables, placeholders, authority citations, and artifact separation.",
"Produces a separate chat-only milestone handoff for downstream OT cost analysis."
],
"limitations": [
"Does not choose statutory authority or make Agreements Officer determinations.",
"Does not create cost estimates, funding profiles, prices, IGCEs, or agreement terms.",
"Requires a DOCX authoring path, Python with python-docx, and a renderer for complete validation.",
"Does not guarantee Microsoft Word behavior when validation uses only LibreOffice."
],
"use_cases": [
{
"title": "Structure a New Prototype OT",
"description": "Turn an approved prototype concept into phases, milestones, deliverables, and objective completion evidence.",
"target_user": "Government program manager"
},
{
"title": "Convert a Technical White Paper",
"description": "Preserve approved technical facts while removing FAR artifact language, staffing details, and pricing content.",
"target_user": "Acquisition specialist"
},
{
"title": "Reduce an Existing Scope",
"description": "Compare scope reductions, show technical and schedule effects, and rebuild approved milestones without estimating savings.",
"target_user": "Technical project lead"
}
],
"prompt_templates": [
{
"title": "Start from a Concept",
"prompt": "Build an OT project description from this concept: [concept]. Ask for missing authority and scope facts before proposing milestones.",
"scenario": "Beginner workflow for an early project concept"
},
{
"title": "Convert a Source Document",
"prompt": "Convert the attached [document type] into an OT project description. Preserve settled technical decisions and exclude all pricing, funding, and FAR artifact content.",
"scenario": "Intermediate workflow for an existing white paper or scope"
},
{
"title": "Design Measurable Milestones",
"prompt": "Using the confirmed [authority] and project outcome, propose phases and milestones with deliverables, objective completion evidence, dependencies, and pending decisions.",
"scenario": "Detailed milestone planning before document generation"
},
{
"title": "Revise and Validate Scope",
"prompt": "Revise the approved project description using these changes: [changes]. Preserve unaffected decisions, show impacts, obtain milestone approval, then generate and validate the DOCX.",
"scenario": "Advanced controlled revision and artifact validation"
}
],
"output_examples": [
{
"input": "Create a Prototype OT description for a software pilot with approved authority but no useful TRL model.",
"output": "A decision summary uses observable maturity evidence, lists pending agreement facts, and proposes measurable software milestones before requesting approval."
},
{
"input": "Convert a priced SOW into an OT project description without carrying cost data into the agreement artifact.",
"output": "The resulting document preserves technical outcomes and acceptance evidence while excluding CLINs, rates, funding, staffing counts, and dollar amounts."
},
{
"input": "Reduce an approved prototype scope while keeping the technical baseline and milestone identifiers.",
"output": "The revision presents reduction choices with capability, evidence, schedule, and risk effects, then updates only the user-approved milestone structure."
}
],
"best_practices": [
"Confirm statutory authority and participant facts before deriving scope.",
"Approve the complete milestone structure before generating the DOCX.",
"Run structural validation and visual page inspection after every document correction."
],
"anti_patterns": [
"Do not ask the skill to choose authority or make participant-status determinations.",
"Do not place costs, funding, labor rates, or the chat handoff inside the project description.",
"Do not claim complete validation when rendering or page inspection was unavailable."
],
"faq": [
{
"question": "Which Other Transaction authorities does this skill support?",
"answer": "It supports Research OTs under 10 U.S.C. 4021, Prototype OTs under 4022, and follow-on production under 4022(f)."
},
{
"question": "Can the skill select the correct authority?",
"answer": "No. The user or Agreements Officer must supply and confirm the authority."
},
{
"question": "Does the project description include cost estimates?",
"answer": "No. It excludes prices, funding, labor rates, contribution calculations, and cost-analysis conclusions."
},
{
"question": "Is TRL required for every project?",
"answer": "No. The skill uses TRL only when supplied or useful, and otherwise relies on observable maturity evidence."
},
{
"question": "What files does the skill produce?",
"answer": "It produces one validated project-description DOCX. The milestone handoff remains in chat and is not saved as a file."
},
{
"question": "How does the skill validate the final document?",
"answer": "It runs the bundled structural validator, renders the DOCX, inspects every page, corrects defects, and repeats available checks."
}
]
},
"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": "authority-and-scope-rules.md",
"type": "file",
"path": "references/authority-and-scope-rules.md",
"lines": 72
},
{
"name": "document-specification.md",
"type": "file",
"path": "references/document-specification.md",
"lines": 107
},
{
"name": "handoff-specification.md",
"type": "file",
"path": "references/handoff-specification.md",
"lines": 52
},
{
"name": "question-blocks.md",
"type": "file",
"path": "references/question-blocks.md",
"lines": 66
},
{
"name": "runtime-adaptation.md",
"type": "file",
"path": "references/runtime-adaptation.md",
"lines": 37
},
{
"name": "validation-gates.md",
"type": "file",
"path": "references/validation-gates.md",
"lines": 48
}
]
},
{
"name": "scripts",
"type": "dir",
"path": "scripts",
"children": [
{
"name": "validate_docx.py",
"type": "file",
"path": "scripts/validate_docx.py",
"lines": 276
}
]
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 162
},
{
"name": "test.md",
"type": "file",
"path": "test.md",
"lines": 56
},
{
"name": "testing.md",
"type": "file",
"path": "testing.md",
"lines": 119
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |