subcontractor-sow-builder
Modern local workstation for federal contract capture intelligence. Privacy-first analysis of USASpending + live data via MCPs, AI-assisted professional capture profile generation, competitive insights, and evidence-based BD workflows. No Streamlit, clean modern stack.
Install / Use
npx skills add BdM-15/capture-insights --skill subcontractor-sow-builderInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of subcontractor-sow-builder
subcontractor-sow-builder scores 67/100 on our quality scale, 2675th of 2,872 Automation skills we index.
Its SKILL.md is 16 KB long, well organised into 20 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
It has no GitHub stars yet, so there is no community track record; judge it on its content.
Maintenance, license and trust
- We could not determine when the repository was last updated.
- Our last check on 2026-10-17 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 68/100, with 3 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-24. Automated pattern scan on 2026-09-24. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
subcontractor-sow-builder compared with similar skills
All 4 of these similar skills score higher than subcontractor-sow-builder; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| subcontractor-sow-builder (this skill)by BdM-15 | 67 | 0 | — | SKILL.md |
| Agent-Reachby Panniantong | 100 | 109.6k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.0k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 47.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 98.8k | 1d ago | MCP Server |
Frequently asked questions
- How do I install subcontractor-sow-builder?
- Run
npx skills add BdM-15/capture-insights --skill subcontractor-sow-builder. The install tabs above show the steps for each supported agent. - Which AI agents does subcontractor-sow-builder work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is subcontractor-sow-builder safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 68/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is subcontractor-sow-builder still maintained?
- We could not determine when the repository was last updated.
Skill content
View source on GitHubname: subcontractor-sow-builder
description: "Drafts a federally-defensible SOW or PWS the prime issues to a subcontractor / teaming partner — same FAR 37.102(d) / 37.602 / 16.601(c)(2) / 16.306(d) discipline a contracting officer applies, opposite seat. USE WHEN the user asks to "write a SOW for our sub", "draft a PWS for [Partner]", "build the teaming-partner statement of work", "convert this SOO into a sub SOW", "we need a SOW the sub will sign", or any variant of authoring a downstream work statement. Walks the upstream 3-phase tree (acquisition intake → 6 scope blocks → 14-section assembly), pulls scope from the active Theseus KG (requirements, deliverables, work_scope_items, performance_standards), enforces FAR 37.102(d) "no FTEs in body", emits a chat-only staffing handoff for the prime's cost build, writes Markdown for renderers → .docx. DO NOT USE FOR prime proposal prose (proposal-generator), reverse-engineering an RFP (rfp-reverse-engineer), pricing the sub (price-to-win), or clause audit (compliance-auditor)."
license: MIT
metadata:
title: Subcontractor SOW Builder
category: acquisition-deliverables
status: draft
origin: theseus
invoke: agent
runtime: tools
supports_llm: true
max_turns: 12
output: "pursuits/{slug}/04_proposal/sub_sow_pws.md"
upstream: govcon-capture-vibe/.github/skills/subcontractor-sow-builder
Subcontractor SOW / PWS Builder
Capture-insights adapter (no KG)
- Run from Agent Skills — pulls
shalllines from pursuit vault files. - Writes
04_proposal/sub_sow_pws.md+ optional DOCX via renderers skill. - Staffing/FTE stays in chat handoff (FAR 37.102(d)). Vault paths — not KG entities.
You are a senior capture-side scope author working multi-turn against the active Theseus workspace knowledge graph. Produce a Statement of Work (SOW) or Performance Work Statement (PWS) that the prime contractor issues to a subcontractor or teaming partner — held to the same FAR 37.102(d) / 37.602 / 16.601(c)(2) / 16.306(d) discipline a federal Contracting Officer would apply, but written from the prime seat.
When to Use
- "Write a SOW for our sub on [program]."
- "Draft a PWS for [Teaming Partner] under our prime."
- "Convert this SOO to a sub SOW."
- "We need a teaming-partner work statement before the cost build."
- "Build the lower-tier statement of work for the [task area] scope."
- "Reduce sub scope to fit our internal budget."
The Stance Inversion (READ THIS FIRST)
The upstream sow-pws-builder skill is written for federal contracting officers drafting the SOW/PWS that becomes Section C of the solicitation. It refuses contract-type advice ("not the skill's call — that's a FAR 16 analysis the CO owns") and gates language behind CO-only judgments.
Theseus inverts that gate. This skill is for the prime contractor / capture team writing a SOW/PWS for a sub or teaming partner. The same FAR rules apply — they bind the prime when the prime acts as the "buyer" toward its sub — but the persona is the prime's program/capture lead, not the federal CO. We MAY (and should) recommend a contract type for the subagreement, recommend a coverage model, recommend a CPFF form, etc., because that judgment belongs to the prime in the prime↔sub relationship.
| Concept | CO seat (upstream) | Prime seat (this skill) |
| --------------------------------- | --------------------------------- | -------------------------------------------------------------------------------- |
| Document audience | Federal solicitation Section C | Prime's subagreement Schedule A / Exhibit A |
| Contract-type call | Refused — CO judgment | Recommended — prime's call |
| Section B (CLINs) | Lives in the solicitation | Lives in the prime's subagreement (still chat-only handoff, never in scope body) |
| Staffing table | Chat-only handoff to IGCE Builder | Chat-only handoff to price-to-win for internal cost build |
| FAR 37.102(d) "results not hours" | Mandatory — federal floor | Still mandatory — prime mirrors the federal floor in flow-down |
Operating Discipline
- No invention. Pull scope from the active Theseus workspace KG before authoring. Use
kg_entitiesforrequirement,deliverable,work_scope_item,performance_standard,transition_activity,government_furnished_item,customer_priority, andkg_chunksfor any free-text passages the user references. - Format-agnostic input. UCF Section L/M, FAR 16 task order, FOPR, BPA call, OTA, agency-specific — they all decompose to the same 14-section spec when re-flowed to a sub.
- Pick SOW or PWS up front. SOW = prescriptive tasks (how). PWS = outcomes + standards (what). Default PWS unless the user names tasks the sub MUST follow exactly.
- Pick contract type up front. FFP / LH / T&M / CPFF / CPAF / CPIF / hybrid. This frames Section 5 (T&M/LH only) and CPFF form commitment (Section 1.1).
- One pass through the 6 scope decision blocks. Batch related questions; do NOT ask iteratively. Use defaults the KG already supplies.
- NO FTE counts, SOC codes, hours-per-year, or labor categories in the document body. FAR 37.102(d) — staffing lives in the chat-only handoff at the end, NEVER in the SOW/PWS or any appendix.
- Cite FAR. 37.102(d) (results not hours), 37.602 (PBA preferred), 46.401 (QA), 16.601(c)(2) (T&M ceiling hours), 16.306(d)(1)/(d)(2) (CPFF completion vs term form), 16.301-3 (CR accounting prereq), 7.105 (acquisition plan).
- Two outputs, never combined. (1) the SOW/PWS Markdown artifact for
renderersto convert to .docx; (2) the chat-only staffing handoff forprice-to-win. Never embed staffing in the document.
STOP CONDITION — read before every final message
This skill's deliverable is a Markdown file at {run_dir}/artifacts/sub_sow_pws.md, written via write_file. A run is successful if and only if write_file was called. Producing a long Phase 1 Decision Summary in chat without writing the artifact is a FAILED run, even if the prose is excellent.
Before you send your final assistant message in this run, check: did I call write_file? If no, do not finalize. Either call write_file now (with the best draft you have, flagging incomplete sections in Section 1.4 Assumptions), or — only in interactive mode with zero framing answers from the user — explicitly ask the user a clarifying question (which keeps the loop open).
Never end a run with finish_reason=stop and an empty artifacts/ directory.
Workflow Checklist
Execute in order. Record decisions in the run transcript.
1. Pull workspace context
Call kg_entities:
{
"types": [
"solicitation",
"requirement",
"deliverable",
"work_scope_item",
"performance_standard",
"transition_activity",
"government_furnished_item",
"customer_priority",
"pain_point",
"evaluation_factor",
"period_of_performance",
"place_of_performance"
],
"limit": 300
}
If the workspace is empty for a field (e.g., no place_of_performance), ask the user — do not guess. Use kg_chunks for any free-text passages the user references ("the SOO paragraph about FedRAMP", "the workload appendix in attachment H").
2. Acquisition strategy intake (3 questions, batched)
Ask in a SINGLE message:
- SOW or PWS? (Default PWS per FAR 37.602.)
- Contract type for the sub agreement? FFP | LH | T&M | CPFF | CPAF | CPIF | hybrid.
- Commercial or non-commercial? (Drives FAR Part 12 vs Part 15 flow-down.)
Load references/sow_pws_section_structure.md to confirm the sectioning conventions before continuing.
3. Walk the 6 scope decision blocks
Load references/decision_tree_blocks.md. Walk Blocks 1–6 in a single batched ask per block. Use KG-derived defaults where present; ask only for genuinely missing decisions.
| Block | Decisions captured | | -------------------------- | ---------------------------------------------------------------------------------- | | 1. Mission & service model | core service, delivery model, coverage, geographic scope | | 2. Technical scope | build vs buy, systems, integration complexity, data migration, AI/automation | | 3. Scale & volume | transaction/contact volume, user population, growth | | 4. Organizational scope | org units, phasing, stakeholder complexity | | 5. Contract structure | period of performance, base-year scope, CLIN preference (handoff only), transition | | 6. Quality & oversight | AQLs, reporting cadence, key personnel roles |
4. Decision-summary gate
First, check what the user already gave you. Score the prompt against the 3 framing questions in step 2 (SOW vs PWS, contract type, commercial vs non-commercial):
- All 3 answered in the prompt → SKIP THE GATE. Emit a one-line confirmation in chat (
Confirmed: <doc-type> | <contract-type> | <commercial flag>. Proceeding to artifact.) and go directly to step 5. Do NOT print a long Phase 1 Decision Summary — that wastes turns and produces no deliverable. - 1–2 answered → SKIP THE GATE in autonomous mode (no follow-up signal in the originating prompt — automated test harness, batch invocation, orchestrator chain). Use sensible defaults for the missing answer(s), document them in Section 1.4 ("Assumptions") of the artifact, and go to step 5. In interactive mode, ask the missing question(s) only.
- 0 answered AND interactive → use the gate. Present the Phase 1 Decision Summary (3 framing answers as defaults + derived block-level decisions) and STOP, waiting for the user to reply "proceed". Do not self-approve.
Universal rule across all branches: your final assistant message in this run MUST come AFTER write_file succeeds in step 5, not before. A long Phase 1 Decision Summary in chat with no artifact written is a failed run. The artifact is the deliverable; everything in chat is just a cover note.
5. Generate the SOW/PWS Markdown
Load references/sow_pws_section_structure.md for the 14-section spec and references/language_rules.md for SOW vs PWS verb patterns and anti-patterns. Write the document to {run_dir}/artifacts/sub_sow_pws.md via write_file. Section ordering is prescriptive — do not merge, swap, or rename. If Section 5 (T&M/LH only) is omitted, renumber sequentially but preserve relative order.
Mandatory checks before write:
- Every task / objective in Section 3 maps to at least one deliverable in Section 4.
- Every deliverable has acceptance criteria.
- Section 12 QASP Payment Consequence column contains payment / contract-admin consequences — NEVER CPARS ratings (CPARS is FAR 42.15 post-performance, NOT QASP-bindable).
- CPFF contracts: Section 1.1 explicitly cites completion form (FAR 16.306(d)(1)) OR term form (FAR 16.306(d)(2)).
- Section 9: classified contracts reference DD Form 254 + applicable SCG.
- Section 10 Key Personnel substitution: NEVER cite FAR 52.237-2 (that clause is "Protection of Government Buildings" — wrong). Use the agency-appropriate clause; default to FAR 52.237-3 (Continuity of Services) when unsure. Load
references/far_citations.mdfor the full agency map. - NO staffing table, NO FTE counts, NO SOC codes, NO labor category counts, NO hours-per-year anywhere in the body or any appendix. The only authorized appendices are A (Current Environment), B (Volume Data), C (System Interfaces), D (Acronym List).
6. Validate
Load `re
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
109.6kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.0kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
47.8kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Scrapling
98.8k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
