shredding-solicitations
Skill5 starsChanged 6 months agoApache-2.0View on GitHub
Shreds a US Federal solicitation into a requirements and compliance matrix. Use when the user needs to shred or analyze an RFP, RFQ, RFI, or task order, build a compliance matrix or requirements matrix, extract shall statements, or cross-walk Section L instructions, Section M evaluation factors, and the Section C/SOW/PWS/SOO requirements. Produces a numbered compliance matrix that maps every requirement to the proposal location that will address it, plus a register of format and submission rules.
In this repository21 other files it gives its agents.
- analyzing-competitorsSkill
- analyzing-debriefsSkill
- auditing-commitmentsSkill
- checking-submission-complianceSkill
- developing-key-personnelSkill
- developing-solution-approachSkill
- developing-teaming-strategySkill
- developing-win-strategySkill
- drafting-proposal-sectionsSkill
- estimating-price-to-winSkill
- managing-proposal-operationsSkill
- narrating-cost-volumesSkill
- outlining-proposalsSkill
- planning-captureSkill
- preparing-oralsSkill
- qualifying-opportunitiesSkill
- responding-to-rfisSkill
- reviewing-color-teamsSkill
- running-review-recoverySkill
- writing-executive-summariesSkill
- writing-past-performanceSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 4 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 17
Use this skill as the first proposal-development step after the RFP releases (or on a draft RFP, to get a head start).
- Distinctive: line 45
Ask these as a numbered list.
- Distinctive: line 60
If the document set is incomplete, shred what is available and list precisely what is missing — an incomplete shred is dangerous if it is …
- Very specific: line 116
Step 8: Write and validate: Write 10-compliance-matrix.md using templates/compliance-matrix.md and the ID scheme in …
- Distinctive: line 142
Trace everything: Every row cites its exact source location (section and paragraph).
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Shredding Solicitations
Take a federal solicitation apart, requirement by requirement, and build the compliance matrix — the table that maps every requirement to the proposal location that answers it. The compliance matrix is the spine of a compliant proposal. Every later proposal skill works against it. A requirement that is not in the matrix is a requirement the proposal will miss, and a missed material requirement is a deficiency.
When to use this skill
Use this skill as the first proposal-development step after the RFP releases (or on a draft RFP, to get a head start). It precedes outlining, drafting, and every volume-specific skill.
It does not build the proposal outline — that is outlining-proposals, which
consumes this matrix. This skill produces the requirements inventory; the
outline turns it into a document structure.
Inputs
Required: the solicitation itself — at minimum Sections L, M, and C (or the
SOW/PWS/SOO and the instructions/evaluation equivalents). Place the document in
the pursuit workspace source/ directory. Include all amendments and the Q&A.
Preferred upstream artifacts:
00-opportunity-profile.md: orienting context.05-win-strategy.md: lets the matrix flag where themes will be threaded.
Without the win strategy, the matrix is still complete; it simply omits the theme-placement column.
Read ../../shared/federal-solicitation-primer.md,
../../shared/glossary.md, and ../../shared/pursuit-workspace.md if not
already read this session. The primer's "proposal triad" guidance governs this
skill.
Intake
Ask these as a numbered list. Skip what the solicitation itself answers.
- The document set. Is the full solicitation available — Sections L and M, the SOW/PWS/SOO, Section H, attachments, all amendments, and the Q&A? What is missing?
- Document structure. Does the solicitation use the standard Uniform Contract Format, or a compressed task-order/commercial format? Where are the instructions, the evaluation factors, and the requirement located?
- Volumes. Does Section L define the proposal volumes and their separation (e.g., Technical, Management, Past Performance, Cost)? What are they?
- Amendments. Have all amendments been incorporated? Did any amendment change Section L, Section M, the requirement, or the due date?
- Win strategy. Is there a
05-win-strategy.mdto cross-reference for theme placement?
If the document set is incomplete, shred what is available and list precisely what is missing — an incomplete shred is dangerous if it is mistaken for a complete one.
Workflow
Solicitation Shred:
- [ ] Step 1: Read the primer's triad guidance; complete intake
- [ ] Step 2: Identify the governing sections and the volume structure
- [ ] Step 3: Extract Section L instruction requirements
- [ ] Step 4: Extract Section M evaluation requirements
- [ ] Step 5: Extract Section C / SOW / PWS / SOO requirements
- [ ] Step 6: Cross-walk L <-> M <-> C; flag conflicts and gaps
- [ ] Step 7: Extract format, page, and submission rules
- [ ] Step 8: Write the compliance matrix (10-compliance-matrix.md) and validateStep 1: Triad and intake. Re-read the primer's "read M, then L, then C" guidance. Run intake.
Step 2: Governing sections and volumes. Locate the instructions, the evaluation factors, and the requirement, by function (the primer explains how when the format is non-standard). Record the volume structure from Section L — it is the top level of the matrix.
Step 3: Section L requirements. Extract every instruction: what each volume
must contain, in what order, what each section must address. Use the requirement
extraction method in references/shredding-method.md — capture every
directive ("shall", "must", "will", and instructional imperatives), each as one
atomic, separately verifiable requirement.
Step 4: Section M requirements. Extract every evaluation factor, subfactor, and element, and the basis of evaluation. Each becomes a matrix row: the proposal must not just address it but win on it.
Step 5: Section C / SOW / PWS / SOO requirements. Extract every performance requirement, deliverable, and standard. For a PWS, capture the outcomes and their measurement; for a SOO, capture the objectives the offeror's proposed SOW must satisfy.
Step 6: Cross-walk. This is the step that distinguishes a real compliance matrix from a checklist. Link each requirement across the triad: which Section M factor evaluates this Section C requirement; which Section L instruction tells the offeror where to write it. Flag two failure types: an L/M conflict or ambiguity (an instruction and an evaluation factor that do not align) and a gap (a Section M factor with no Section L instruction, or a Section C requirement no factor evaluates). Conflicts and ambiguities are candidate questions for the contracting officer.
Step 7: Format and submission rules. Extract every page limit, font and
margin rule, file format and naming rule, volume separation rule, the due date
and time, the submission method, and required forms, certifications, and
representations. These go in a separate register (checking-submission-compliance
relies on it). A proposal can be rejected on these alone.
Step 8: Write and validate. Write 10-compliance-matrix.md using
templates/compliance-matrix.md and the ID scheme in
references/compliance-matrix-format.md. Run the template's validation
checklist: every requirement is atomic and traceable to its source location,
the cross-walk is complete, conflicts and gaps are flagged, and the format
register is complete.
Output
One artifact: 10-compliance-matrix.md in the pursuit workspace, including the
format and submission register as a labeled section.
Present the user with: the volume structure, the requirement count by section, the flagged L/M conflicts and gaps (with suggested CO questions), and the binding format constraints (page limits especially).
References
references/shredding-method.md: requirement extraction, requirement language, atomic requirements, the L/M/C cross-walk, handling PWS and SOO.references/compliance-matrix-format.md: the matrix structure, the requirement ID scheme, the columns, and the compliance status values.templates/compliance-matrix.md: the compliance matrix artifact template and its validation checklist.
Guardrails
- Atomic requirements. One requirement per row. A compound instruction split into three checkable parts is three rows. Compounds hide missed obligations.
- Trace everything. Every row cites its exact source location (section and paragraph). A requirement with no traceable source is suspect.
- Do not invent or soften. Extract what the solicitation says. Do not add requirements that are not there, and do not downgrade a "shall" to a "should".
- Flag, do not resolve, ambiguity. Where L and M conflict or a requirement is genuinely unclear, flag it as a CO question. Guessing the government's intent is how proposals become non-compliant.
- Section L wins. Where this package's conventions differ from the solicitation's instructions, the solicitation governs.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

