Skip to content

feat: weighted quality scoring with category breakdown#5

Open
kagurachen28-prog wants to merge 1 commit intoNeuZhou:masterfrom
kagurachen28-prog:fix/1-improve-skill-quality-scoring
Open

feat: weighted quality scoring with category breakdown#5
kagurachen28-prog wants to merge 1 commit intoNeuZhou:masterfrom
kagurachen28-prog:fix/1-improve-skill-quality-scoring

Conversation

@kagurachen28-prog
Copy link

Fixes #1

Changes

Replace equal-weight scoring with weighted categories:

Category Weight Checks
Description 25% Length penalty: too short (<20) or too long (>500)
Examples 25% Count + code block quality
API docs 20% Reference + coverage depth
Triggers 15% when to use + when not to use
References 15% Install, features, tests

New: --explain-score shows per-category breakdown.
All 140 existing tests pass. Backward compatible (legacyScore still works).

Replace equal-weight scoring with weighted categories:
- Description quality (25%): penalizes too short (<20 chars) or too long (>500)
- Examples (25%): count + code block quality check
- API docs (20%): reference + coverage depth
- Triggers (15%): when to use / not use
- References (15%): install, features, tests

Add --explain-score flag to show per-category breakdown.
Add countCodeBlocks helper for example quality assessment.
Update tests to reflect new scoring weights.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Improve skill quality scoring algorithm

1 participant