Skip to content

feat(trending): give Skills a lasting trending award - #432

Merged
harlan-zw merged 6 commits into
mainfrom
feat/trending-awards
Oct 6, 2026
Merged

harlan-zw merged 6 commits into
mainfrom
feat/trending-awards

Conversation

@harlan-zw

@harlan-zw harlan-zw commented Oct 5, 2026 •

Copy link
Copy Markdown
Collaborator

🔗 Linked issue

No linked issue.

❓ Type of change

  • 📖 Documentation
  • 🐞 Bug fix
  • 👌 Enhancement
  • ✨ New feature
  • 🧹 Chore
  • ⚠️ Breaking change

📚 Description

A Skill that trends has no record of it once it leaves the board. This PR gives it a trending award that stays.

  • The hourly record-trending-awards task reads the week and month boards through loadTrendingBoard, the loader the trending page uses. It keeps the best rank each evidenced row reaches per ISO week or calendar month in skill_trending_awards. Star filler and the all range earn nothing.
  • The Skill page shows the best award beside the heading, for example #2 trending · Sep 2026. The chip links to the board that awarded it.
  • The README badge adds a rose award segment with ?trending=1. A repository badge shows the best award of its Skills. The badge editor offers the option only when the Skill holds an award.
  • Awards are display only. They never feed trust, admission, indexability, or order.

VISION lists badges among the things a growth-hacking Skill author wants. ADR-0011 records why this award is different: it repeats a claim the board already made, with the post or star surge behind it. VISION principle 4 gains an awards carve-out, and GLOSSARY.md gains the term "trending award".

The Skill API reads awards as a JSON column on the existing Skill row, so an uncached Skill page still makes four D1 reads.

Architecture: the hourly task writes skill_trending_awards; the Skill API and the README badge route read it

🤖 AI disclosure: Harlan Agent Kit modified this description. My AI open-source policy.

A Skill that trends has no record of it once it leaves the board.
Record the best rank each evidenced row reaches per week and month,
show it beside the Skill heading, and let the README badge carry it.
@harlan-zw

Copy link
Copy Markdown
Collaborator Author

Agent check (Claude Code, not Harlan). Checked by hand on a local build (wrangler dev, local D1 with migration 0139 and two seeded awards), since CI cannot cover it:

  • GET /api/skills/anthropics/skills/mcp-builder returned both awards, best first.
  • GET /b/anthropics/skills/mcp-builder?trending=1 served the award segment with max-age=3600. The repository badge picked the best award of its Skills.
  • The chip renders at 1280px in both themes and at 375px with no horizontal scroll.
Skill heading, light Skill heading, phone
Skill heading with the award chip, light theme Skill heading at 375px, chips wrap

README badge variants with the award segment on GitHub light and dark backgrounds

@harlan-github-agent harlan-github-agent Bot added harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. labels Oct 5, 2026
@harlan-github-agent

harlan-github-agent Bot commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

🤖 MERGED

Harlan Agent Kit posted this automated review. It is not Harlan's personal review or approval. AI open source policy. Last updated: 2026-10-06 04:30 UTC.

GitHub merged this pull request.

  • Logged (20/100): The PR's visual evidence is unverifiable by this review, so the author's rendering claims rest on geometry checks alone. View code
    • Ask an agent to verify and fix this finding
  • Logged (10/100): The badge editor's award default can go stale when the award prop arrives after mount. View code
    • Ask an agent to verify and fix this finding

Review completed. No finding above 80/100.

Selected findings run after merge and open separate pull requests.

@harlan-zw harlan-zw added harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. harlan-agent-review Pull request triage requires an adversarial Review. Adding this label manually always forces one. labels Oct 5, 2026
@harlan-github-agent harlan-github-agent Bot added harlan-agent-running An Agent holds a Task on this issue or pull request right now. and removed harlan-agent-review Pull request triage requires an adversarial Review. Adding this label manually always forces one. harlan-agent-running An Agent holds a Task on this issue or pull request right now. labels Oct 5, 2026
# Conflicts:
#	layers/registry/app/components/SkillDetail.vue
@harlan-github-agent harlan-github-agent Bot added harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-pending The automated Review is waiting on a gate for this head commit. and removed harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. labels Oct 5, 2026

@harlan-github-agent harlan-github-agent Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Harlan Agent Kit posted this automated review. AI open source policy.

Automated Review: READY.

Read the Review results

@harlan-github-agent harlan-github-agent Bot added harlan-agent-ready The automated Review passed every gate on this head commit. and removed harlan-agent-pending The automated Review is waiting on a gate for this head commit. labels Oct 5, 2026
DESIGN.md now marks trending with the braille spark, so the chip and
the README badge use it instead of a lucide icon. The badge matches
owner and repo case-insensitively, which the binary primary key cannot
serve, so the migration adds a NOCASE index.
@harlan-github-agent harlan-github-agent Bot added harlan-agent-blocked The automated Review found a material defect in this head commit. harlan-agent-running An Agent holds a Task on this issue or pull request right now. and removed harlan-agent-blocked The automated Review found a material defect in this head commit. harlan-agent-running An Agent holds a Task on this issue or pull request right now. labels Oct 5, 2026
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.

1 participant