Skip to content
Skills Library
Personal productivity · Building & coding

github-profile

/github-profile

Create or update an animated, living GitHub profile README with github-profile-kit (one profile.toml, a GitHub Action, live stats, a skyline with real weather). Use when someone asks to make, pimp, redesign or refresh a GitHub profile, or when an agent with its own GitHub account wants a profile of its own.

Licence
MIT
Last repository change
10.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
1
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 10.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

What it does and when to use it

Create or update an animated, living GitHub profile README with github-profile-kit (one profile.toml, a GitHub Action, live stats, a skyline with real weather). Use when someone asks to make, pimp, redesign or refresh a GitHub profile, or when an agent with its own GitHub account wants a profile of its own.

Original author description

Create or update an animated, living GitHub profile README with github-profile-kit (one profile.toml, a GitHub Action, live stats, a skyline with real weather). Use when someone asks to make, pimp, redesign or refresh a GitHub profile, or when an agent with its own GitHub account wants a profile of its own.

How it works

  1. Ground rules
  2. Procedure
  3. Updating later
  4. Machine interface
Original SKILL.md headings · 52 lines, 677 words
SKILL.md preview
---
name: github-profile
description: Create or update an animated, living GitHub profile README with github-profile-kit (one profile.toml, a GitHub Action, live stats, a skyline with real weather). Use when someone asks to make, pimp, redesign or refresh a GitHub profile, or when an agent with its own GitHub account wants a profile of its own.
---

# GitHub profile with github-profile-kit

You turn one `profile.toml` into a complete profile README: header, contact row, focus cards, terminal, recommended repos, contribution stats and a living skyline. A GitHub Action rebuilds it every 30 minutes. No dependencies beyond Python 3.11 and `gh`.

## Ground rules

- **Publishing is outward-facing.** A profile README is public. Before you push or create a public repository, show the human what will be published (the `preview` output or the README text) and get a clear yes, unless they already told you to publish. An autonomous agent publishing its *own* profile follows its operator's rules.
- **Never overwrite an existing profile README without consent.** If `<login>/<login>` already has a README, move its text into the `<!-- CUSTOM:START -->` block of the generated README, or ask.
- **Only real facts.** Every line in `profile.toml` must be true for the person (or agent). Draft from public data, then confirm what you could not verify. Do not invent employers, numbers or projects.
- **Validate before you build.** `validate --json` returns machine-readable errors with a JSON path; fix exactly those keys.

## Procedure

1. **Identify the account.** `gh api user --jq .login` gives the login of the authenticated account. The profile repository must be named exactly like the login: `<login>/<login>`.
2. **Get the kit into that repository.**
   - Repository does not exist: `gh repo create <login>/<login> --public --template onetechgroupll/github-profile-kit --clone` (confirm first, see ground rules).
   - Repository exists: clone it, then copy `profilekit/`, `.github/workflows/`, `skills/`, `AGENTS.md` from the kit into it.
3. **Draft the config.** In the repository root: `python3 -m profilekit init --from-github --handle <login>`. This reads name, company, location, bio and top languages.
4. **Refine with the human** (or from the agent's own purpose). Ask for what public data cannot tell you, in one round:
   - 3 to 5 rotating words after "I build" (e.g. `"data pipelines."`)
   - up to four focus areas with two short lines each, and a visual per card: `auction`, `retail`, `sync`, `ledger`
   - links (https only; LinkedIn, website, Mastodon, Bluesky, X, RSS, mail)
   - city for the skyline with lat/lon/timezone, an optional 1-3 letter rooftop sign, landmarks from `tower bridge spire wheel dome`
   - optional terminal: whoami line, `--flags` with role descriptions, process names, principles
   - optional repos to recommend
   Every key, limit and allowed value: `python3 -m profilekit schema`.
5. **Validate:** `python3 -m profilekit --json validate`. Exit code 0 means valid. Otherwise fix each `errors[].path`; messages say why (most often a text that would not fit the graphic).
6. **Preview:** `python3 -m profilekit preview` writes `assets/`, `dist/`, `README.md` and `preview.html` with sample data for live graphics. If you can drive a browser, open `preview.html` and look at it in light and dark before publishing. Check that nothing overlaps or is cut off.
7. **Publish** (after consent): commit `profile.toml`, `README.md`, `assets/`, the workflows and push to `main`. The `profile` workflow then fetches live data and publishes `dist/` to the `output` branch, which the README references.
8. **Verify:** `gh run watch` on the profile workflow, then open `https://github.com/<login>`. Raw images are cached up to 5 minutes.
9. **Tell the human two manual steps** you cannot do for them:
   - Private contributions only count if they enable *Settings → Profile → Include private contributions on my profile*.
   - The avatar is not set by the kit. `assets/avatar-light.svg` is a square skyline crop they can convert and upload.

## Updating later

Edit `profile.toml`, run `validate`, push. Never edit `README.md` outside the CUSTOM block; it is regenerated. `python3 -m profilekit doctor` checks Python, config, remote name and workflows.

## Machine interface

All commands accept `--json` before the subcommand and return exit code 0 (ok), 1 (invalid / failed check) or 2 (usage):

| Command | Does |
|---|---|
| `init [--handle L] [--from-github] [--force]` | writes `profile.toml` |
| `validate` | checks against `profilekit/schema.json` |
| `build [--offline] [--phase] [--weather] [--season]` | renders everything; `GITHUB_TOKEN` enables live data |
| `preview` | offline build + `preview.html` |
| `schema` | prints the JSON Schema |
| `doctor` | environment and repository checks |

Versions

RepositoryScoreLicence
This page · onetechgroupll/github-profile-kit90MIT
xiaodu55/github-profile-skill95MIT
jdevalk/skills90MIT

Database snapshot: 13.11.2026 · package version e5854bc12620 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90profile-cards
    Build or refresh a designed GitHub profile README (header, stats, languages, contribution heatmap with streaks, pinned repos) as light and dark animated SVG cards, and add a daily GitHub Action that keeps it current. Use when the user wants a nicer GitHub profile page or profile README.
  • 90github-profile-proof-updater
    Refresh and verify a GitHub profile or public proof layer. Use when the user wants to update GitHub profile visuals, replace README assets while preserving paths, audit profile image references, validate live GitHub rendering, prepare LinkedIn/X proof copy, or document a profile-refresh proof trail.
  • 95github-profile-update
    Updates the candidate's GitHub profile fields with accurate, ready-to-paste content. Use when the user asks to update, refresh, or improve their GitHub profile, bio, status, or README. Also trigger after AZ-900 or AI-200 exam results to update cert-related fields. Contains exact…
  • 100github-glowup
    Audit and upgrade a candidate's GitHub profile the way recruiters and interviewers see it, covering profile README, pinned repos, repo READMEs, descriptions, topics, commit history and red flags, then draft the fixes (profile README, repo READMEs, descriptions) and apply them…
  • 100github-presence
    When the user wants to optimize their GitHub profile, README, or project discoverability. Trigger phrases include "GitHub README," "README optimization," "GitHub profile," "GitHub stars," "GitHub discoverability," "awesome lists," or "GitHub marketing.
  • 100github-presence
    When the user wants to optimize their GitHub profile, README, or project discoverability. Trigger phrases include "GitHub README," "README optimization," "GitHub profile," "GitHub stars," "GitHub discoverability," "awesome lists," or "GitHub marketing.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.