agentleFS
oaslanankaoaslananka/easyeda-mcp-pro/skills/design-validation/SKILL.md

design-validation

Skill67 starsChanged 10 days agoMITView on GitHub

EasyEDA DRC/ERC, semantic ERC, power-tree, PCB constraints, production QA, export, and release-validation workflow through EasyEDA MCP Pro.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this skill when an AI agent is asked to validate an EasyEDA Pro schematic, PCB, BOM, export, or production handoff through EasyEDA MCP …

    line 8
  2. Distinctive:

    Use this skill for:

    line 14
  3. Distinctive:

    Do not use this skill to approve a project for fabrication or assembly without qualified human review.

    line 25
  4. Very specific:

    Run schematic validation with easyeda_erc_run, easyeda_semantic_erc_auto (or ..._validate if working from a hand-authored netlist), and …

    line 120
  5. Very specific:

    Run PCB validation with easyeda_drc_run, easyeda_rule_check_summary, and board inspection tools when PCB scope is included.

    line 121
  6. Distinctive:

    Run power-tree and critical-net validation when the design has named rails, current constraints, or safety-sensitive nets.

    line 122
  7. Distinctive:

    Run PCB constraint and production review tools against the provided manufacturer constraints.

    line 123
  8. Distinctive:

    Stop and report clearly when:

    line 146

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

Design Validation Skill

Use this skill when an AI agent is asked to validate an EasyEDA Pro schematic, PCB, BOM, export, or production handoff through EasyEDA MCP Pro.

This skill is specific to oaslananka/easyeda-mcp-pro and must stay aligned with the registered MCP tools in src/tools/ and the tool list in README.md.

When to use

Use this skill for:

  • ERC review
  • DRC review
  • Semantic ERC and netlist checks
  • PCB constraint review
  • Power-tree analysis
  • BOM and sourcing validation
  • Production QA and export readiness review
  • Manufacturing handoff risk reporting

Do not use this skill to approve a project for fabrication or assembly without qualified human review.

Required context

Collect:

  • Active EasyEDA project and bridge status
  • Which document tab is focused in EasyEDA Pro — schematic validation tools need the schematic tab active, PCB validation tools need the PCB tab active. A tool called against the wrong tab does not error, it silently returns an empty/not_available result — do not report "no issues found" from a validation run that may simply have had no data to check.
  • Validation target: schematic, PCB, BOM, export, quote, or production package
  • Manufacturer or assembly constraints
  • Power rails, currents, connector requirements, and critical nets
  • Expected board stackup and mechanical constraints
  • Export directory and artifact requirements
  • Existing waivers or accepted risks

Staged engineering evidence routing

For mixed schematic/PCB/release requests, follow the one canonical, on-demand engineering phase router: requirements and focused document → exact component/datasheet → schematic/ERC → power and placement → routed PCB/DRC → source-versioned DFM/DFT → documented human review. Select only requested phases; do not load unrelated standard catalogs.

  • The existing easyeda_semantic_erc_validate can accept caller-declared datasheetConstraints for exact part/package/revision and pin/rail evidence. Native ERC is aggregate; the declared review is neither a live EasyEDA readback nor independent datasheet authentication.
  • easyeda_design_rules_lookup has on-demand trace-current-review, protocol-routing, decoupling, dfm-checklist and isolation-emc-review topics; distinguish guidance from measured facts.
  • easyeda_pcb_production_review accepts an optional manufacturer/process manufacturerProfile with revision and source. A within-declared-limit observation is not fabrication approval; missing native geometry is UNKNOWN.
  • Agent sequencing, checking standard applicability, exact datasheet sources, complete return paths and human sign-off are skill guidance, not automatically enforced MCP compliance gates. Respect profile permissions, confirmWrite and readback on every requested mutation.

Primary MCP tools

Health and capability checks

  • easyeda_health_check
  • easyeda_bridge_status
  • easyeda_get_capabilities
  • easyeda_get_tool_profiles
  • easyeda_run_self_test
  • easyeda_live_write_regression (dev profile) — exercises real write paths against the live bridge and reports pass/fail per step; use to distinguish "the bridge itself is misbehaving" from "the design has real issues" when validation results look suspicious

Schematic validation

  • easyeda_erc_run — native ERC is coarse (per-severity aggregate counts only, e.g. "1 warning"); it does not natively report which pin/net/component is affected. This tool supplements it with inferred_floating_pins/detail_source (best-effort, located via netlist inference) — treat detail_source: 'native_aggregate_only' as a signal that no itemized detail is available for that run.
  • easyeda_semantic_erc_auto — extracts nets/devices/pins from the live schematic and runs semantic ERC without a hand-authored netlist. Electrical types are inferred from pin/net naming conventions, not verified against EasyEDA's own metadata (which is unreliably populated — a passive part's pins can report a native type like "IN"). Prefer this over easyeda_semantic_erc_validate when the goal is validating what's actually drawn, not a hypothetical netlist.
  • easyeda_semantic_erc_validate — same rule engine as ..._auto, but takes a fully hand-authored nets/devices structure. Use when the schematic isn't drawn yet, or when inferred classification isn't trustworthy enough for the check being run.
  • easyeda_schematic_validate_netlist
  • easyeda_schematic_verify_write
  • easyeda_schematic_components
  • easyeda_schematic_nets
  • easyeda_schematic_net_detail
  • easyeda_power_tree_analyze

PCB validation

  • easyeda_drc_run — native PCB DRC is coarse (per-severity aggregate counts only), with no itemized-violation inference layer (unlike easyeda_erc_run). Report a DRC pass/fail as "N errors, location unknown — open the DRC panel in EasyEDA Pro for detail," not as a located finding.
  • easyeda_rule_check_summary
  • easyeda_board_layers
  • easyeda_board_stackup
  • easyeda_board_dimensions
  • easyeda_board_features
  • easyeda_pcb_constraint_check
  • easyeda_pcb_constraint_report
  • easyeda_pcb_production_review

BOM and sourcing validation

  • easyeda_bom_generate
  • easyeda_bom_validate
  • easyeda_bom_sourcing
  • easyeda_bom_quality_report

Export and production checks

  • easyeda_export_gerbers
  • easyeda_export_pick_place
  • easyeda_export_pdf
  • easyeda_export_netlist
  • easyeda_production_qa_artifacts
  • easyeda_jlcpcb_quote_workflow
  • easyeda_canvas_capture
  • easyeda_canvas_capture_region

Workflow

  1. Confirm server and bridge state with easyeda_health_check and easyeda_bridge_status.
  2. Confirm that the active profile exposes the needed validation tools.
  3. Run schematic validation with easyeda_erc_run, easyeda_semantic_erc_auto (or ..._validate if working from a hand-authored netlist), and easyeda_schematic_validate_netlist when schematic scope is included.
  4. Run PCB validation with easyeda_drc_run, easyeda_rule_check_summary, and board inspection tools when PCB scope is included.
  5. Run power-tree and critical-net validation when the design has named rails, current constraints, or safety-sensitive nets.
  6. Run PCB constraint and production review tools against the provided manufacturer constraints.
  7. Validate BOM and sourcing if assembly or procurement is in scope.
  8. Generate export and production QA artifacts only when validation blockers are known and reported.
  9. Capture visual evidence when layout or schematic readability matters.
  10. Produce a final report that separates blocking issues, warnings, unknowns, waivers, and human-review items.

Quality checks

A complete validation response must include:

  • Health and bridge status
  • Active tool profile
  • ERC result summary
  • DRC result summary
  • Semantic/netlist result summary
  • PCB constraints and production review
  • BOM and sourcing status when relevant
  • Export artifact status when relevant
  • Blockers, warnings, unknowns, and waivers
  • Human-review checklist

Failure modes

Stop and report clearly when:

  • EasyEDA bridge is disconnected
  • Required validation tools are hidden by the active tool profile
  • ERC/DRC tools cannot obtain project data — check document tab focus (schematic vs PCB) before treating an empty result as "no issues"
  • Manufacturer constraints are missing for production review
  • BOM/sourcing data is incomplete
  • Export tools fail or artifact paths are ambiguous
  • The user asks to ignore unresolved critical issues

Output format

Return:

  • Validation scope
  • Tools used
  • Results by domain
  • Findings by severity
  • Waivers and assumptions
  • Export/production artifact status
  • Final verdict: blocked, needs fixes, needs human review, or candidate after human review

Safety rule

A clean automated validation result is not production approval. Production release requires human review of EasyEDA files, exports, BOM, assembly data, and manufacturer constraints.

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.