mcpField
E
edge-concept-synthesizer

edge-concept-synthesizer

github.com/mphinanceOther3284 installsUpdated 3d ago
Repository

About edge-concept-synthesizer

edge-concept-synthesizer is a skill for structuring evidence from raw tickets before strategy drafting. It clusters recurring conditions and writes YAML concepts with a thesis, support statistics, invalidation signals, and an export-readiness flag.

Key features

  1. 01Clusters ticket evidence
  2. 02Summarizes recurring conditions
  3. 03Creates abstract theses
  4. 04Records support statistics and invalidation signals
  5. 05Marks export readiness

Use cases

  1. 01Organize large sets of raw tickets
  2. 02Review concepts before drafting strategies
  3. 03Reduce direct ticket-to-strategy overfitting

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mphinance/alpha-skills --skill edge-concept-synthesizer

After installing, type/edge-concept-synthesizerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.md
agents/
openai.yaml
references/
concept_schema.md
scripts/
synthesize_edge_concepts.py
scripts/tests/
conftest.py
test_synthesize_edge_concepts.py

Details

From the project README

Edge Concept Synthesizer

Overview

Create an abstraction layer between detection and strategy implementation. This skill clusters ticket evidence, summarizes recurring conditions, and outputs edge_concepts.yaml with explicit thesis and invalidation logic.

When to Use

  • You have many raw tickets and need mechanism-level structure.
  • You want to avoid direct ticket-to-strategy overfitting.
  • You need concept-level review before strategy drafting.

Prerequisites

  • Python 3.9+
  • PyYAML
  • Ticket YAML directory from detector output (tickets/exportable, tickets/research_only)
  • Optional hints.yaml

Output

  • edge_concepts.yaml containing:
    • concept clusters
    • support statistics
    • abstract thesis
    • invalidation signals
    • export readiness flag

Workflow

  1. Collect ticket YAML files from auto-detection output.
  2. Optionally provide hints.yaml for context matching.
  3. Run scripts/synthesize_edge_concepts.py.
  4. Deduplicate concepts: merge same-hypothesis concepts with overlapping conditions (containment > threshold).
  5. Review concepts and promote only high-support concepts into strategy drafting.

Quick Commands

python3 skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py \
  --tickets-dir /tmp/edge-auto/tickets \
  --hints /tmp/edge-hints/hints.yaml \
  --output /tmp/edge-concepts/edge_concepts.yaml \
  --min-ticket-support 2

# With hint promotion and synthetic cap
python3 skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py \
  --tickets-dir /tmp/edge-auto/tickets \
  --hints /tmp/edge-hints/hints.yaml \
  --output /tmp/edge-concepts/edge_concepts.yaml \
  --promote-hints \
  --max-synthetic-ratio 1.5

# With custom dedup threshold (or disable dedup)
python3 skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py \
  --tickets-dir /tmp/edge-auto/tickets \
  --output /tmp/edge-concepts/edge_concepts.yaml \
  --overlap-threshold 0.6

python3 skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py \
  --tickets-dir /tmp/edge-auto/tickets \
  --output /tmp/edge-concepts/edge_concepts.yaml \
  --no-dedup

Resources

  • skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py
  • references/concept_schema.md

Comments

Markdown supported