What types of matching problems does this skill support?

It supports one-sided and two-sided matching, weighted assignments, hierarchical entity resolution, and constrained optimization problems like the hospital-resident or student-school models.

Can this skill help debug inconsistent or unstable matching results?

Yes, it includes specific diagnostic procedures for identifying root causes of non-determinism, such as unseeded RNG, floating-point issues, or iteration order sensitive to hash maps.

How does it handle complex business rules in matching logic?

The skill provides a translation framework to convert business requirements into formal constraints including capacity limits, sibling coupling, exclusions, and priority ordering.

Does this skill provide implementation patterns for hierarchical data?

Absolutely. It includes procedures for hierarchy traversal, inheritance of constraints, and preference aggregation across nested entities like org charts or taxonomies.

Hierarchical Matching Systems

Name: Hierarchical Matching Systems
Author: petekp

bypetekp

0•

API Development

Architects, implements, and debugs complex matching algorithms and hierarchical assignment systems.

This skill provides a rigorous framework for building and troubleshooting sophisticated matching systems, ranging from two-sided markets like school admissions to multi-level organizational hierarchies. It guides developers through formal problem classification, translates business requirements into mathematical constraints, and offers detailed diagnostic procedures for resolving issues like unstable matches or preference misalignments. By following its standardized checklists and architectural patterns, users can ensure their matching logic is deterministic, optimal, and resistant to common algorithmic pitfalls found in complex allocation and entity resolution tasks.

Key Features

01Formal translation of business requirements into capacity, coupling, and exclusion constraints

02Standardized classification for one-sided, two-sided, and hierarchical matching problems

03Rigorous debugging protocols for instability, floating-point errors, and hierarchy traversal bugs

04Validation procedures for verifying stability, completeness, and constraint satisfaction

05Comprehensive decision guides for selecting algorithms like Gale-Shapley or the Hungarian algorithm

060 GitHub stars

Use Cases

01Building automated task assignment engines with complex worker hierarchies and hard constraints

02Designing stable school-to-student or resident-to-hospital placement systems

03Debugging and optimizing entity resolution and record linkage logic across nested taxonomies

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add petekp/agent-skills hierarchical-matching-systems

For use in Claude.ai and ChatGPT

Download Skill