skills.rest
jdevalk
jdevalkCOMMUNITY
Explore all skills by this author →
Website𝕏@jdevalkGitHub

github-profile

Audit and optimize GitHub profile READMEs, metadata, pinned repositories, and widgets.

93|9|Updated Mar 14, 2026
Search Tags:#github#audit#readme#metadata#widgets#profile#pinned-repos
One-click install
npx skills add https://github.com/jdevalk/skills --skill github-profile-jdevalk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-profile
Source: https://github.com/jdevalk/skills/tree/main/github-profile
Command: npx skills add https://github.com/jdevalk/skills --skill github-profile-jdevalk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GitHub profiles are often underutilized storefronts. This skill audits and optimizes profile pages by addressing the profile README, metadata fields, pinned repositories, contribution visibility, and helpful widgets, for both personal profiles and organization pages.

Core Features & Use Cases

  • Audit the Profile README structure and messaging to identify gaps, readability issues, and opportunities for stronger first impressions.
  • Generate a polished, scannable profile README tailored to goals, including greeting, current work, tech stack badges, GitHub stats, featured projects, and social links.
  • Recommend metadata tweaks (bio, location, website, pronouns, status), a strategic pinned-repos lineup, and widget configuration; verify rendering and badge URLs.
  • Extend support to organization profiles with CTAs for hiring, contributions, and governance, plus recommended canonical links.

Quick Start

Launch the skill to audit your profile and generate an optimized README with metadata and widget guidance.

Frequently Asked Questions about github-profile

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I optimize my GitHub profile README to stand out?▼

Optimize your GitHub profile README by auditing its structure, messaging, and readability, then generating a polished page with greeting, tech stack badges, GitHub stats, featured projects, and social links for a stronger first impression.

What should I include in a GitHub profile audit?▼

A GitHub profile audit should review your profile README content, metadata fields like bio and location, pinned repositories lineup, contribution visibility, and widget configurations to identify gaps and opportunities for improvement.

Can I generate a GitHub organization profile README with CTAs?▼

Yes, you can generate a GitHub organization profile README that includes calls to action for hiring, contributions, and governance, along with recommended canonical links and metadata tweaks tailored to organizational goals.

How do I verify GitHub stats badges and widget URLs render correctly?▼

Verify GitHub stats badges and widget URLs by validating the badge links during the optimization process, ensuring they render correctly within the profile README without broken images or misconfigured widgets.

What is the best way to choose pinned repositories for a GitHub profile?▼

The best way to choose pinned repositories is to apply a strategic pin lineup based on your goals, selecting projects that showcase your strongest work and align with the messaging in your profile README.

Does this GitHub profile optimization work for both new and existing READMEs?▼

Yes, this optimization supports both creating a new profile README from scratch and refreshing an existing one, providing deterministic outputs like a ready-to-publish README, metadata tweaks, and validated widget configurations.

Related Skills

Explore More Content & Communication Skills→
mickpletchermickpletcher
14

github-readme

Generate README.md content from repository context and file trees.

Community
Intermediate
jonathimerjonathimer
84

github-presence

Optimize GitHub READMEs, profiles, and topics to improve project discoverability.

Community
Intermediate
jangtrinhjangtrinh

github-readme

Generate GitHub profile READMEs with hero banners, badges, and dynamic widgets.

Community
Advanced
hcassar93hcassar93

google-ads-cli-skill

Configure and authenticate Google Ads CLI across multiple profiles for automated workflows.

Community
Intermediate