Add One-Shot Skills Reliability and Guardrails

[bpulluta]

Summary

This PR hardens the one-shot extraction skills to make setup and iteration more repeatable, simpler to follow, and safer against runtime misconfiguration.

What Changed

• Updated extraction-run/SKILL.md
  • Added preflight checks before running.
  • Added explicit pass/fail gates:
    • treat runs with zero extracted jurisdictions as failed extraction quality.
    • treat config exceptions in logs as failures even if process exits successfully.
• Updated plugin-config-setup/SKILL.md
  • Added non-negotiable runtime constraints.
  • Added canonical required heuristic_keywords structure with all required lists.
  • Added minimal run-config contract that prompts users to provide their own model name and client settings.
• Updated document-retrieval/SKILL.md
  • Added required heuristic list expectations and explicit failure behavior when missing/empty.
  • Normalized keyword naming guidance to canonical forms.
• Updated schema-creation/SKILL.md
  • Added quality gate requiring smoke runs to produce extracted rows, not just process completion.

Why

users can avoid common setup mistakes and get a working, repeatable baseline faster.

Testing Notes

• Documentation/skill-only updates.
• Guidance now reflects validated runtime constraints and triage behavior.

[bpulluta]

@copilot open a new pull request to apply changes based on the comments in this thread

[Copilot]

@bpulluta I've opened a new pull request, #399, to work on those changes. Once the pull request is ready, I'll request review from you.

[bpulluta]

see my review

[ppinchuk]

Thanks!