agentleFS
adeerkhanadeerkhan/vitruvius/skills/standards-lookup/SKILL.md

standards-lookup

Skill10 starsChanged 4 days agoMITView on GitHub

Find, retrieve, and cite engineering standards provisions reproducibly. Use when a claim, design check, or research question requires a specific provision from AISC, ACI, ASCE, IEEE, NFPA, ASME, AASTO, Eurocode, IBC, or other engineering standard. Examples: ACI 318 strength-reduction factors, ASCE 7 load combinations, AISC 360 bolt shear values. Selects the authoritative standard, locates the section, resolves conflicts between overlapping standards, and returns the provision with enough provenance that another engineer can verify it. Use when locating and citing a provision is the job — judging whether a provision supports a conclusion belongs to the verifier. Do NOT use for general engineering knowledge that has no specific standard backing.

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 8 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈8

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Before searching, name the question, the artifact/scope (or say it is a literature review), the jurisdiction/edition, and the effort budget …

    line 37
  2. Distinctive:

    Offer a free alternative: if one answers the same question (e.g., a FHWA manual provision that parallels an AASTO clause).

    line 113
  3. Distinctive:

    When a claim invokes a provision, verify the obligation level.

    line 130
  4. Distinctive:

    When two applicable standards give different answers, do not silently pick one — report both and identify which the project specification …

    line 136
  5. Distinctive:

    Check the scope clause and footnotes — "except" clauses are where governing provisions hide.

    line 145
  6. Distinctive:

    If the provision is paywalled and cannot be retrieved, say so explicitly and provide the most specific citation possible.

    line 180
  7. Distinctive:

    Read the relevant reference file before attempting any lookup.

    line 193
  8. Distinctive:

    Always cite the edition — provisions change between editions (AISC 360-16 vs -22 differ.

    line 254

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md
<!-- VITRUVIUS-COMPILED-SKILL:BEGIN v1 sha256=a6ac9fe52d3a5932b64aeb8630734ad9d70d06b016f45990075213ea0e08718e -->

Standards Lookup

This skill catalogs the major engineering standards bodies with their selection logic, section-lookup patterns, access methods, and citation formats. Your job is to turn the user's engineering question into a reproducible provision retrieval: select the authoritative standard, locate the governing section, retrieve or reference the provision text, and return it with enough provenance that another engineer can verify it.

Engineering standards differ from scientific databases: most are paywalled, many have no public API, and the same question may be answered differently by different jurisdictional standards. This skill handles those realities explicitly.

Input Gate

Before searching, name the question, the artifact/scope (or say it is a literature review), the jurisdiction/edition, and the effort budget (user-set or thorough). Ask ONE clarifying question if the ask is too vague, then proceed. See references/input-gate.md.

Core Workflow

  1. Select the authoritative standard — Use the Standard Selection Guide below. Prefer the primary standard for the domain + jurisdiction. Do not fan out across many standards just because they are available.
  2. Locate the governing section — Engineering standards organize by limit state (flexure, shear, compression, stability, connections). Use the section-lookup patterns in the reference file to navigate. Distinguish mandatory provisions ("shall") from advisory ("should", "may", commentary).
  3. Return the provision with provenance — If free access or preview is available, retrieve the provision text directly. If paywalled, cite the exact provision (standard, section, edition, page) so the user can locate it in their copy. Never paraphrase a "shall" provision — quote it or flag the paraphrase. When two applicable standards conflict, report both and identify which the project specification designates as governing.

Standard Selection Guide

By engineering domain

DomainPrimary US standardsCross-check / alternate
Structural steelAISC 360 (specification), AISC 341 (seismic), AISC 358 (connections)AASTO LRFD (bridges), AWS D1.1 (welding)
Structural concreteACI 318 (buildings), ACI 350 (environmental)ACI 349 (nuclear), Eurocode 2 (EU)
Cold-formed steelAISI S100—
MasonryTMS 402/602ACI 530 (equivalent)
Timber / woodNDS (sawn, GLT, CLT)AWC manuals, SDPWS (seismic, wood)
AluminumADM (Aluminum Design Manual)—
Loads (general)ASCE 7 (minimum design loads)IBC (adopts ASCE 7 by reference), state-specific amendments
GeotechnicalASCE 7 Ch. 18 (soils/foundations), state DOT specsACI 336 (deep foundations), FHWA manuals
BridgesAASTO LRFD Bridge Design SpecsAISC 360 (steel bridges), ACI 318 (concrete bridges), state DOT
Fire protectionNFPA 1 (Fire Code), NFPA 101 (Life Safety), IBC Ch. 7-9NFPA 5000 (building code), FM Global data sheets
ElectricalNEC (NFPA 70), IEEE 1547 (interconnection), IEEE 519 (harmonics)UL standards, IEC (international), state amendments
MechanicalASME B31 (pressure piping), ASME BPVC (boilers/pressure vessels)API (petroleum), AWS D15 (railroad welding)
ArchitecturalADA (accessibility), IBC (planning), ASHRAE 90.1/62.1 (energy/ventilation), NFPA 101 (egress)ICC A117.1 (accessibility), IECC (energy), LEED (sustainability)
Materials / testingASTM (testing methods), AISC/ACI material specsISO (international), EN (European)
SoftwareISO/IEC 25010 (quality), OWASP ASVS (security), NIST SSDF (secure dev)IEEE 830 (requirements), IEEE 1012 (V&V)

By jurisdiction

JurisdictionGoverning framework
United States (general)IBC + referenced standards (ASCE 7, AISC 360, ACI 318, NDS, TMS 402)
United States (state-specific)State amendments to IBC; California (CBC), Texas, New York City, etc.
EuropeEurocodes (EN 1990–EN 1999) + National Annexes

Access Methods

Most engineering standards are paywalled. This is a first-class constraint, not an afterthought.

Access tiers

TierStandardsHow to retrieve
Free full textSome NFPA handbooks (preview), Eurocode national annexes (some countries), NIST standards, select FHWA/AASHTO manuals, IBC (free online via ICC)Direct link or search the free portal
Free preview / limitedAISC (selected sections free), ASCE (abstracts + select open articles), ACI (select guides)Retrieve what the preview allows; cite the rest by section
Subscription APIIEEE Xplore (IEEE standards), some ASTM via institutional accessRequires user's API key or institutional login; skill cannot bypass
Paywalled, no APIMost AISC/ACI/ASME/ASTM full documentsCite provision with exact reference; tell the user they need their own copy
Publicly purchasableAll major standards bodies sell PDF/printProvide purchase link as fallback

What to do when access is blocked

  1. Cite precisely — standard, section, edition, and page number (or equivalent locator) so the user can find it in their licensed copy.
  2. Flag the access limitation explicitly in the output.
  3. Never reconstruct a "shall" provision from memory or secondary sources — this is how dangerous errors creep in. If you cannot retrieve the provision, say so and provide the citation.
  4. Offer a free alternative if one answers the same question (e.g., a FHWA manual provision that parallels an AASTO clause).

Provision Types and Mandatory Language

Engineering standards use precise obligation levels. Distinguish them in your output:

LanguageMeaningVerdict impact
"shall"Mandatory. Non-negotiable requirement.Violation = non-compliant
"shall not"Mandatory prohibition.Violation = non-compliant
"should"Recommended. Advisory, not mandatory.Departure requires justification
"may"Permissive. Allowed but not required.Optional
"is permitted to"Permissive.Optional
CommentaryExplanatory text, not part of the enforceable standard.Informative only; cite as commentary

When a claim invokes a provision, verify the obligation level. A researcher who treats a "should" as a "shall" (or vice versa) has made a compliance error.

Conflict Resolution

When two applicable standards give different answers, do not silently pick one — report both and identify which the project specification designates as governing. Never silently pick the more conservative value; conservatism is a design decision, not a retrieval decision.

Section-Lookup Patterns

Identify the limit state (flexure, shear, compression, stability, connections), then find the chapter and provision in the reference file. Check the scope clause and footnotes — "except" clauses are where governing provisions hide.

Output Format

Structure your response like this:

## Retrieval Summary
- Standard:
- Edition / date:
- Section(s):
- Access: retrieved | preview-only | paywalled (cited) | unavailable
- Jurisdiction assumed:

## Provision
[Exact text if retrieved, or exact citation if paywalled]

## Obligation level
[shall / should / may / commentary]

## Applicability check
[Does the provision actually apply to the case? Scope confirmed?]

## Conflicts / cross-checks
[Any overlapping standards with different requirements]

## Provenance
- Source: [standard + section + edition]
- Access method: [free / preview / paywalled / unavailable]
- Access date:
- Identifier conversions or assumptions:
- Warnings: [paywall, edition differences, jurisdiction limits, scope gaps]

If the provision is paywalled and cannot be retrieved, say so explicitly and provide the most specific citation possible. Do not reconstruct mandatory provisions from memory.

Adding New Standards

Each standard is a self-contained reference file in references/. To add one: create references/<standard-abbrev>.md (scope, edition history, access method, chapters by limit state, key sections, mandatory-language conventions, known conflicts, jurisdiction notes) and add an entry to the Standard Selection Guide.

Available Standards

Read the relevant reference file before attempting any lookup.

Structural Steel

StandardReference FileAccessWhat it covers
AISC 360references/aisc-360.mdFree preview / paywalledStructural steel buildings — the central US steel specification
AISC 341references/aisc-341.mdPaywalledSeismic provisions for steel structures
AISC 358references/aisc-358.mdPaywalledPrequalified steel connections
AISI S100references/aisi-s100.mdPaywalledCold-formed steel
AWS D1.1references/aws-d1-1.mdPaywalledStructural welding (steel)

Concrete

StandardReference FileAccessWhat it covers
ACI 318references/aci-318.mdFree preview / paywalledConcrete building code — the central US concrete specification
ACI 350references/aci-350.mdPaywalledEnvironmental concrete structures

Masonry

StandardReference FileAccessWhat it covers
TMS 402/602references/tms-402.mdPaywalledMasonry structures

Bridges and Transportation

StandardReference FileAccessWhat it covers
AASTO LRFDreferences/aasto-lrfd.mdPaywalled (some manuals free)Bridge design — steel, concrete, fatigue

Fire and Life Safety

StandardReference FileAccessWhat it covers
NFPA 1 / 101references/nfpa.mdFree handbook preview / paywalledFire code, life safety code
IBC (fire chapters)references/ibc.mdFree (online)Fire resistance, means of egress (IBC Ch. 7-10, 10)

Electrical

StandardReference FileAccessWhat it covers
NEC (NFPA 70)references/nec.mdFree online view (NFPA) / paywalled downloadNational Electrical Code — the US electrical installation standard
IEEE Xplorereferences/ieee.mdSubscription APIIEEE standards library (1547, 519, 802, etc.)

Mechanical

StandardReference FileAccessWhat it covers
ASMEreferences/asme.mdPaywalledPressure vessels (BPVC), piping (B31.1/31.3), GD&T (Y14.5), elevators (A17.1)

Materials and Testing

StandardReference FileAccessWhat it covers
ASTMreferences/astm.mdPaywalled (some free)Material testing methods and material specifications

Timber and Masonry

StandardReference FileAccessWhat it covers
NDSreferences/nds.mdFree preview / paywalledWood design (sawn, GLT, CLT, connections)
TMS 402/602references/tms-402.mdPaywalledMasonry structures

Citing Engineering Standards

Format: [Standard Abbreviation] [Number]-[Edition], §[Section], [Title] ([Publisher], [Year]).

Example: AISC 360-22, §F2-1, Flexural Members (AISC, 2022).

Always cite the edition — provisions change between editions (AISC 360-16 vs -22 differ; ACI 318-14 vs -18 had major shear changes). When the user references a standard without an edition, ask which one or note the assumption.

Scope and Boundaries

  • This skill retrieves and cites standards provisions — it does NOT produce final designs or construction documents.
  • Research-only, not for final engineering sign-off. Retrieved provisions support engineering research but must be reviewed by a licensed engineer for any design application. Standards applicability (jurisdiction, edition, scope) is the user's responsibility.
  • Evidence quality: see references/evidence-quality-tiers.md.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.