Skip to content
Skills Library
Design & UX · Building & coding

github-profile-terminal

/github-profile-terminal

Create or update a personalized terminal-style GitHub profile README with an ASCII portrait, project and contact links, and optional public-statistics refresh. Use when a user asks to design, build, or publish a GitHub profile, an ASCII avatar profile, or a terminal-style profile card.

Licence
MIT
Last repository change
02.11.2026

Assessment and security

100/ 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.
Content35 / 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
7
Scripts
2
HTML comments
0
URLs in SKILL.md
0
Deprecation

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

Licence

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

What to check before installing
  • 2 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/create_profile.py, scripts/render_profile.py

What it does and when to use it

Create or update a personalized terminal-style GitHub profile README with an ASCII portrait, project and contact links, and optional public-statistics refresh. Use when a user asks to design, build, or publish a GitHub profile, an ASCII avatar profile, or a terminal-style profile card.

Original author description

Create or update a personalized terminal-style GitHub profile README with an ASCII portrait, project and contact links, and optional public-statistics refresh. Use when a user asks to design, build, or publish a GitHub profile, an ASCII avatar profile, or a terminal-style profile card.

How it works

  1. Workflow
  2. Commands
Original SKILL.md headings · 19 lines, 417 words
SKILL.md preview
---
name: github-profile-terminal
description: Create or update a personalized terminal-style GitHub profile README with an ASCII portrait, project and contact links, and optional public-statistics refresh. Use when a user asks to design, build, or publish a GitHub profile, an ASCII avatar profile, or a terminal-style profile card.
---

# GitHub Profile Terminal

Create an accessible SVG profile card and README from the user's confirmed public details. The bundled generator produces a self-contained profile repository; it does not require the skill after generation.

## Workflow

1. Establish the GitHub username and any preferred display name, focus, workflow, up to three projects, up to two contacts, tagline, and theme (`blue`, `violet`, or `mint`). Use supplied facts and verified public links. Never invent achievements, counts, or affiliations. Keep unknown fields empty. Ask for an avatar image only when one is not already available; offer a placeholder if the user prefers.
2. Copy `assets/example-config.json` to a working JSON file and replace its example values. Choose `include_forks` deliberately. The star total excludes GitHub-marked forks by default; set `excluded_repos` for mirrors or other repositories the user does not want counted. Only include information the user intends to make public.
3. Run `scripts/create_profile.py` with `--config CONFIG.json --output NEW_EMPTY_DIRECTORY`. Add `--avatar-image LOCAL_IMAGE` to convert an image with Pillow, or `--avatar-text FILE` for a 58-column-by-38-row ASCII portrait. Without either option, a placeholder is used. The source image is never copied to the output. Install Pillow only if needed and permitted by the environment.
4. Add `--fetch-stats` only to fetch initial **public** GitHub statistics; otherwise numbers display as dashes. Add `--auto-refresh` only if the user wants a daily GitHub Actions workflow with repository `contents: write` permission. The generator refuses to write into a nonempty output directory. Validate the SVG and show a rendered preview, checking long or CJK text and link destinations.
5. If publication is authorized, inspect the target GitHub account and existing `USERNAME/USERNAME` repository first. The repository and README must be public for a profile README to appear. Preserve existing README content and workflows: merge the generated content deliberately instead of overwriting unrelated work. Do not publish personal information or modify an account without the user's authorization. After publishing, verify the actual profile image and links; if Actions was enabled, check the first run and report any failure.

## Commands

From the profile output directory, `python3 scripts/render_profile.py --update` refreshes the SVG using only public GitHub API data. It uses `GITHUB_TOKEN` if present, never requires a personal access token, and leaves the previous SVG untouched if fetching fails. The README's project/contact links are created at generation time; update those links in `README.md` when editing them later. The generator's built-in help describes all options.

The scripts use Python's standard library except for converting image files, which requires Pillow. `assets/refresh-profile.yml` is copied only when explicitly requested.
Files in this package (7)
  • SKILL.md 3 KB
  • agents/openai.yaml 1 KB
  • assets/example-config.json 1 KB
  • assets/placeholder-avatar.txt 1 KB
  • assets/refresh-profile.yml 1 KB
  • scripts/create_profile.py 4 KB
  • scripts/render_profile.py 12 KB

Versions

The database has no other skills named github-profile-terminal.

Database snapshot: 13.11.2026 · package version 31abacf5d712 (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

  • 100github-profile-builder
    Design, build and publish a standout GitHub profile README with a banner made for the person, project cards, verified widgets and weekly activity. Use for any GitHub profile or profile README request.
  • 100githubcard
    Create embeddable GitHub profile and repository card images with the ghcard CLI, design custom card layouts, and add them to README files. Use when the user wants a GitHub stats card, a profile card, a repo card or banner, a social preview image for a repository, or to put such…
  • 100ascii-sharks-lite
    Add an animated ASCII ocean (fish schools hunted by sharks: classic, hammerhead, great hammerhead, tiger, zebra, mako, thresher, nurse) to a web page with one script tag, play it in the terminal, or export it as an SVG for a README. Use when the user wants an…
  • 100retro-profile-readme
    Builds a retro, paper-and-pixel GitHub profile README (username/username repo) by interviewing the user. It asks short questions with concrete options (name and figlet font, ASCII/braille art from a bundled gallery or their own, bio, stack, social links, terminal footer), then…
  • 100ascii-art
    Build ASCII art that looks designed rather than generated. Covers animated and interactive ASCII scenes on a canvas, images, logos and text turned into ASCII, ASCII hero sections, backgrounds and login pages, plain-text ASCII art, and loopable ASCII videos for X and other feeds.…
  • 100portfolio-github
    Build or update a professional portfolio website (static, responsive, light/dark, deployed to GitHub Pages with an Actions workflow) and a GitHub profile README from the user's master_resume.json, plus a PUBLIC resume PDF without phone, street address or visa status. Use when…

Feedback and reports

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