Skip to content

Update featured projects and add README link check - #1

Merged
jahau merged 1 commit into
mainfrom
feat/profile-featured-projects
Nov 18, 2026
Merged

jahau merged 1 commit into
mainfrom
feat/profile-featured-projects

Conversation

@jahau

@jahau jahau commented Nov 18, 2026 •

Copy link
Copy Markdown
Owner

Updates the profile README's featured projects from the current state of the account, and adds a validation check.

What changed

  • Featured Open-Source Projects now lists six original repositories, adding workflow-trust-check, agent-permission-map, and agent-session-diff to the existing three. Each row has a language and dynamic shields.io badges for the latest release and stars. Nothing is hand-written.
  • Separate links to the original repositories and forks filters, so originals and forks are clearly distinguished. No forks are featured.
  • The introduction, What I Do, Technologies, Open Source, and Connect sections are unchanged.
  • scripts/check_readme.py: Markdown table column consistency, relative links, external link status, http:// links, and a check that shields.io GitHub badges point at a repository that exists (shields.io renders an image even for missing repositories). Standard library only.
  • .github/workflows/readme-check.yml: runs the check on push, pull requests, and weekly. Uses only the SHA-pinned actions/checkout, with read-only permissions.
  • MAINTAINING.md: criteria for featuring a project, how to update, how validation works, and recommended pins.

Verification

Featured repositories, checked through the GitHub API:

Repository Original License Latest release Docs and example
workflow-trust-check yes MIT v0.1.0 install, usage, example
agent-permission-map yes Apache-2.0 v0.1.0 quick start, CI usage, examples
agent-session-diff yes MIT v0.1.0 install, bundled examples
ai-repo-rules-generator yes MIT v0.2.1 install, usage, examples
wp-security-doctor yes MIT v0.2.0 install, usage, example output
github-contribution-doctor yes MIT v0.2.0 quick start, sample output

Not featured:

  • Handlet: original, but has no release, license, or description.
  • All other public repositories are forks.

Achievements: GitHub has no API for profile achievements, so they could not be verified and none are claimed.

Link check: python scripts/check_readme.py README.md MAINTAINING.md reports 0 problems. A test file with deliberate errors (bad table row, missing relative file, badge for a nonexistent repository, 404 link, http:// link) produced all 5 expected errors.

Pinned repositories (manual step, not done by this PR)

The six current pins are already these original projects. Recommended order, newest and broadest first:

  1. workflow-trust-check
  2. agent-permission-map
  3. agent-session-diff
  4. ai-repo-rules-generator
  5. wp-security-doctor
  6. github-contribution-doctor

Pins can only be changed in the GitHub web UI (Customize your pins).

Suggestion, not applied

The Technologies section does not list Go or Rust, although two featured projects use them. It was left unchanged as requested; adding Go · Rust would make it consistent.

- Feature six original projects with published releases, adding
  workflow-trust-check, agent-permission-map and agent-session-diff
- Add language and dynamic release badges next to the existing dynamic
  star badges
- Link separately to original repositories and forks
- Add a standard-library Markdown table and link checker, including a
  check that shields.io GitHub badges refer to existing repositories
- Run the check on push, pull requests and weekly
- Document featuring criteria, the update process and recommended pins
@jahau
jahau merged commit e2284fe into main Nov 18, 2026
2 checks passed
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