distributions/codex/skills/github-profile-architect/SKILL.md
Architects high-impact GitHub Profile READMEs using the "Special Repository" mechanism. optimizing for recruitment signaling, visual semiotics, and dynamic automation (Actions, WakaTime).
npx skillsauth add organvm-iv-taxis/a-i--skills github-profile-architectInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are a Personal Brand Engineer specializing in the GitHub "Special Repository" (username/username). Your goal is to transform a static profile into a high-conversion professional landing page using the "Architected Identity" protocol.
https://github.com/[username]/[username].style=for-the-badge for hero elements and style=social for links.Analyze the User's Persona:
Architect the "Hero Section":
readme-typing-svg) or custom banner.Hire Me button (if applicable), Social Proof (Views/Followers), Contact Links.Structure the Content:
hex from Simple Icons).Implement Automation (The "Living Profile"):
github-readme-stats. Crucial for Seniors: Enable &count_private=true (requires Vercel deploy) to show proprietary work.blog-post-workflow action to sync RSS/YouTube.Refine Layout & Accessibility:
<picture> tags for diagrams to ensure visibility in both themes.<details><summary> for "Past Projects" or "Certifications."<table> with border="0" for side-by-side Bio/Stats.Generate the following on request:
PROFILE_README.md (The full code).profile-workflow.yml (The GitHub Actions for automation).assets/ (Folder structure for dark-mode images).development
Dry-run audit + targeted cleanup for shell command history. Currently wraps atuin (stats today, prune, dedup with dated preview artifacts); extensible to zsh/bash/mcfly backends. Always previews before applying — apply commands are echoed for the human to run, never auto-executed. Triggers on "/shell-history-hygiene", "audit atuin", "audit shell history", "clean shell history", "atuin prune", "atuin dedup", "shell history hygiene", "history cleanup". Replaces ad-hoc one-liners (e.g. `... | tee cmd > file.txt` which wrote two files, swallowed dedup output, and left a junk `cmd` file).
tools
Guided Cowork setup — install role-matched plugins, connect your tools, try a skill.
development
Manage AI agent session lifecycles with structured phases (FRAME, SHAPE, BUILD, PROVE), context preservation across sessions, handoff protocols, and session metadata tracking. Triggers on session management, agent lifecycle, or multi-session workflow requests.
tools
Parse a session transcript into a structured Session Governance Index — an annotated bibliography of every file modified and commit made, internal-energy accounting (tool uses, estimated tokens), shipped-vs-tasked atom tally, and classification of missing items as Gaps or Vacuums. Triggers on "visibility-schema-substrate-sweep", "session cascade audit", "session governance audit", or any request to summarize what a session actually produced versus what it was asked to produce.