From example-skills
Organizes GitHub repositories for professional presentation and maintainability with README templates, repo patterns, naming conventions, visibility strategies, and profile optimization. Useful for repo audits, cleanup, and open source presentation.
How this skill is triggered — by the user, by Claude, or both
Slash command
/example-skills:github-repo-curatorThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Transform scattered repositories into professional portfolio.
Transform scattered repositories into professional portfolio.
Create [username]/[username]/README.md for profile landing:
# Hi, I'm [Name] 👋
[One-line positioning statement]
## 🔭 Currently Working On
- [Project 1] - [Brief description]
- [Project 2] - [Brief description]
## 🌱 Currently Learning
- [Technology/Skill]
## 💼 Professional Focus
[2-3 sentences about your work and interests]
## 📫 How to Reach Me
- [Email/LinkedIn/Website]
## 🛠️ Tech Stack


[Add relevant badges]
---
[Optional: GitHub stats, activity graph, etc.]
Pin 6 repositories that showcase:
# Pattern: [type]-[name] or [name]-[technology]
# Good
portfolio-website
cli-tool-name
react-component-library
python-data-pipeline
api-gateway-service
# Avoid
test123
my-project
untitled
asdfgh
| Visibility | Use For |
|---|---|
| Public | Portfolio pieces, open source, learning |
| Private | Client work, incomplete projects, experiments |
| Archive | Completed/abandoned but worth keeping |
| Delete | Truly obsolete, embarrassing, or redundant |
For each repo, decide:
# Project Name
Brief description of what this project does.
## Installation
```bash
npm install project-name
import { thing } from 'project-name';
thing.doSomething();
MIT
### Standard README
````markdown
# Project Name



One-paragraph description of the project: what it does, who it's for,
and why it exists.
## Features
- ✅ Feature one
- ✅ Feature two
- ✅ Feature three
## Quick Start
### Prerequisites
- Node.js >= 18
- npm or yarn
### Installation
```bash
git clone https://github.com/user/project
cd project
npm install
npm start
[Link to full docs or wiki]
[Link to CONTRIBUTING.md]
This project is licensed under the MIT License - see the LICENSE file.
### Comprehensive README
See `references/readme-template.md`
---
## Documentation Standards
### File Structure
```
project/
├── README.md # Project overview
├── CONTRIBUTING.md # How to contribute
├── LICENSE # License file
├── CHANGELOG.md # Version history
├── CODE_OF_CONDUCT.md # Community standards
├── docs/ # Extended documentation
│ ├── getting-started.md
│ ├── api-reference.md
│ ├── examples.md
│ └── troubleshooting.md
├── .github/
│ ├── ISSUE_TEMPLATE/
│ │ ├── bug_report.md
│ │ └── feature_request.md
│ ├── PULL_REQUEST_TEMPLATE.md
│ └── workflows/ # GitHub Actions
└── src/ # Source code
```
### CONTRIBUTING.md Template
```markdown
# Contributing to [Project Name]
Thank you for your interest in contributing!
## How to Contribute
### Reporting Bugs
1. Check existing issues
2. Use the bug report template
3. Include reproduction steps
### Suggesting Features
1. Check existing feature requests
2. Use the feature request template
3. Explain the use case
### Pull Requests
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## Development Setup
[Instructions for local development]
## Code Style
[Style guidelines or link to linter config]
## Testing
[How to run tests]
```
### CHANGELOG.md Template
```markdown
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/),
and this project adheres to [Semantic Versioning](https://semver.org/).
## [Unreleased]
### Added
- New feature X
### Changed
- Updated dependency Y
### Fixed
- Bug in feature Z
## [1.0.0] - 2024-01-15
### Added
- Initial release
- Feature A
- Feature B
```
---
## Badges
### Build & Status
```markdown


```
### Package Info
```markdown


```
### License & Social
```markdown



```
### Technology
```markdown


```
### Badge Generator
Use [shields.io](https://shields.io) for custom badges.
---
## Repository Cleanup Workflow
### Phase 1: Audit
1. List all repositories
2. Categorize by purpose/status
3. Identify gaps (what's missing?)
4. Flag for action (keep/archive/delete)
### Phase 2: Clean
1. Delete truly obsolete repos
2. Archive completed/abandoned
3. Make private anything not portfolio-ready
4. Update visibility settings
### Phase 3: Polish
1. Add/update READMEs
2. Add licenses
3. Update descriptions and topics
4. Add relevant badges
5. Clean up commit history if needed
### Phase 4: Present
1. Pin best repositories
2. Create/update profile README
3. Organize with topics/labels
4. Cross-link related projects
---
## Topics/Tags Strategy
### Use Topics For:
- Primary language: `python`, `typescript`, `rust`
- Framework: `react`, `nextjs`, `fastapi`
- Domain: `machine-learning`, `web-dev`, `cli`
- Type: `library`, `tool`, `template`, `tutorial`
- Status: `active`, `archived`, `experimental`
### Example Topic Set:
```
typescript react nextjs portfolio web-development
```
---
## Git Hygiene
### Commit Messages
```
type(scope): subject
body (optional)
footer (optional)
```
Types: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`
### Branch Strategy
```
main # Production-ready
develop # Integration branch
feature/* # New features
bugfix/* # Bug fixes
release/* # Release prep
hotfix/* # Production fixes
```
### .gitignore Essentials
```gitignore
# Dependencies
node_modules/
venv/
.env
# Build
dist/
build/
*.pyc
# IDE
.vscode/
.idea/
*.swp
# OS
.DS_Store
Thumbs.db
# Secrets
*.pem
*.key
.env.local
```
---
## References
- `references/readme-template.md` - Full README template
- `references/license-guide.md` - Choosing a license
- `references/github-actions.md` - CI/CD workflows
npx claudepluginhub a-organvm/a-i--skills --plugin document-skillsProvides a checklist for code reviews covering functionality, security, performance, maintainability, tests, and quality. Use for pull requests, audits, team standards, and developer training.