improve

Verify plugin skill claims against Effect v4 source code and runtime behavior.

2|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/spencerbeggs/effected --skill improve-spencerbeggs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improve
Source: https://github.com/spencerbeggs/effected/tree/main/.claude/skills/improve
Command: npx skills add https://github.com/spencerbeggs/effected --skill improve-spencerbeggs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the drift between documentation and actual library behavior by enforcing a rigorous evidence-based verification process for plugin skills.

Core Features & Use Cases

  • Evidence Ladder: Enforces a strict hierarchy of verification (docs, source code, and runtime probes) to ensure skill claims are factually accurate.
  • Harvest & Tune Workflow: Provides a structured loop to turn migration failures into actionable GitHub tickets and subsequently verify fixes against the vendored Effect v4 source.
  • Use Case: When a migration reveals that a previously documented Effect function has been removed or renamed, use this skill to audit the existing skill documentation, verify the change via a runtime probe, and update the plugin's knowledge base.

Quick Start

Use the improve skill to harvest migration defects into tickets or tune existing skills by verifying them against the vendored source.

Frequently Asked Questions about improve

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify Effect v4 documentation against actual runtime behavior?

To verify Effect v4 documentation against runtime behavior, use a structured evidence ladder that cross-references claims against vendored source code and runtime probes to resolve discrepancies. This prevents stale technical knowledge from propagating.

What is the best way to fix TypeScript migration defects when library functions are removed?

The best way to fix TypeScript migration defects from removed library functions is a harvest and tune workflow that turns migration failures into actionable GitHub tickets and verifies fixes against the vendored Effect v4 source code.

Why does my Effect documentation drift from the actual implementation after a migration?

Documentation drift from the actual implementation happens during library migrations when previously documented functions are removed or renamed without updating technical knowledge bases. An evidence-based verification process audits and corrects these discrepancies systematically.

Can I use runtime probes to audit TypeScript plugin skills for accuracy?

Yes, you can use runtime probes to audit TypeScript plugin skills for accuracy by enforcing strict probe protocols and source-lookup invariants. This ensures claims are factually accurate against actual Effect v4 library behavior.

When do I need an evidence ladder for TypeScript library migration verification?

You need an evidence ladder for TypeScript library migration verification when a migration reveals that previously documented functions have been removed, renamed, or changed, requiring audit and validation against the vendored source.

What are the limitations of verifying documentation without source code lookup invariants?

Without strict source code lookup invariants, verification processes risk propagating incorrect technical knowledge because documentation claims cannot be definitively resolved against the actual Effect v4 implementation behavior.