sort-unsorted

Re-classify unsorted INDEX rows using repository metadata and taxonomy rules.

8|1|Updated Apr 20, 2018
One-click install
npx skills add https://github.com/Executioner1939/awesome-engineering-research --skill sort-unsorted
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sort-unsorted
Source: https://github.com/Executioner1939/awesome-engineering-research/tree/main/.claude/skills/sort-unsorted
Command: npx skills add https://github.com/Executioner1939/awesome-engineering-research --skill sort-unsorted

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It re-classifies entries stuck in the unsorted bucket so your INDEX stays accurate, searchable, and aligned with the shared taxonomy.

Core Features & Use Cases

  • Targets unsorted backlog: Finds rows in INDEX/sources.md and INDEX/tools.md where category=unsorted or kind=unsorted (active only).
  • Enriches candidates for better decisions: Pulls repository metadata (description, topics, and README excerpts) and source page details to improve classification accuracy.
  • Re-applies the standard taxonomy: Uses the same category vocabulary and kind heuristic from the categories rules, while narrowing only (never moving a fine category back to unsorted).
  • Produces reviewable outcomes: Updates the rows and opens a PR, keeping uncertain second-pass cases marked so humans can fix them.

Quick Start

Use sort-unsorted to drain the current unsorted backlog by running it with default target=both and max_rows=50.

Frequently Asked Questions about sort-unsorted

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

FAQPage Schema
How do I reclassify unsorted items in a markdown index file?

To reclassify unsorted items in a markdown index, parse INDEX/sources.md and INDEX/tools.md, fetch external page metadata for enrichment, and re-apply taxonomy rules to update category rows. This process narrows classifications and generates a PR summary for review.

Why does automated tagging leave ambiguous repository entries in an unsorted backlog?

Automated tagging leaves ambiguous repository entries in an unsorted backlog because conservative classification rules avoid widening categories. A second-pass lookup fetches external repo metadata like descriptions and topics to enrich data and improve accuracy before reclassification.

What is the best way to clean up untagged GitHub repos using taxonomy heuristics?

The best way to clean up untagged GitHub repos is using a second-pass enrichment lookup that fetches repository topics and README excerpts. It re-applies category vocabulary heuristics to narrow classifications and opens a PR with uncertain cases marked for human review.

Can I target only unsorted sources or tools when cleaning up my data index?

Yes, you can target unsorted sources or tools by specifying the target parameter. Running with default target=both processes up to max_rows=50 active rows where category=unsorted or kind=unsorted across both INDEX files.

Does this reclassification process move items back to the unsorted category?

No, the reclassification process never moves a fine category back to unsorted. It strictly narrows classifications by re-applying the standard taxonomy rules while keeping uncertain second-pass cases marked so humans can fix them.

What are the limitations of using repository metadata for topic enrichment?

A limitation of using repository metadata for topic enrichment is that ambiguous items may still lack sufficient details. The system handles this by keeping uncertain second-pass cases marked in the PR summary for human review rather than forcing a classification.