| name | GitHub for Beginners |
| description | This skill provides comprehensive guidance for learning and using GitHub, from fundamental concepts through practical workflows. Designed for complete beginners, this skill should be used when teaching GitHub concepts, explaining git workflows, debugging git/GitHub issues, or guiding through practical GitHub tasks like creating branches, commits, pull requests, and merging code. |
GitHub for Beginners - Complete Learning Skill
Purpose
This skill transforms GitHub novices into self-sufficient users by providing clear explanations, practical commands, and solutions to common problems. It covers everything from foundational concepts through advanced workflows, evolving with the user's skill level.
When to Use This Skill
Use this skill when:
- Teaching Concepts: Explaining Git, GitHub, branches, commits, PRs, or other core concepts
- Guiding Workflows: Helping users execute practical tasks (creating PRs, merging branches, etc.)
- Debugging Problems: Troubleshooting merge conflicts, undoing changes, or other errors
- Answering Questions: Clarifying what something means or why it works that way
- Best Practices: Advising on conventional workflows and standards
How to Use This Skill
All procedural knowledge is organized in reference files for easy lookup and context management:
Core References
references/git-basics.md - Foundational concepts and mental models
- Understanding Git vs GitHub distinction
- Key concepts: repositories, commits, branches, remotes
- Mental models and analogies for abstract ideas
- Philosophy and why these patterns exist
references/commands-reference.md - Complete command dictionary
- Organized by workflow and frequency of use
- Every command includes: what it does, common variations, when to use it
- Covers setup, daily work, branching, merging, undoing changes
- Examples for each command
references/workflows.md - Step-by-step procedures for common tasks
- Complete workflows for: making your first commit, creating a PR, merging code, etc.
- Multi-step processes broken down with explanations
- Integration with Claude Code workflow (since the user has this setup)
- Collaboration patterns and team workflows
references/troubleshooting.md - Common problems and solutions
- Organized by problem category (merge conflicts, undo operations, permission issues, etc.)
- Diagnostic questions to identify the problem
- Step-by-step solutions with explanations
- Prevention tips for future
references/claude-code-integration.md - GitHub + Claude Code
- How Claude Code works with GitHub (the user's current setup)
- Using @claude in issues and PRs
- Workflow for collaborative development with Claude Code
- Best practices for the GitHub App integration
Using These References
When responding to a user question:
- Assess the question - Determine which reference(s) contain relevant information
- Load references - Read the appropriate sections from the reference files
- Apply knowledge - Use the structured information to answer clearly
- Provide examples - Give practical examples from commands-reference when relevant
- Connect concepts - Link back to foundational understanding from git-basics
Progressive Learning Path
The skill is designed for progression:
Level 1: Novice (Current)
- Understanding core concepts
- Making first commit
- Creating branches
- Opening first PR
- Basic troubleshooting
Level 2: Intermediate (Next)
- Advanced merge strategies
- Rebasing workflows
- Stashing and cleaning
- Complex troubleshooting
- Collaborating with teams
Level 3: Advanced (Future)
- Advanced git workflows (gitflow, trunk-based)
- Performance optimization
- Custom git hooks
- Repository maintenance
- Mentoring others
Key Principles
Clarity Over Completeness: Explain concepts clearly rather than covering every edge case upfront.
Practical First: Lead with practical examples and real commands before diving into theory.
Progressive Disclosure: Build knowledge layer by layer, not overwhelming with information.
Student-Centered: Acknowledge the user's current level and guide them appropriately.
References as Sources of Truth: Maintain detailed information in references for future expansion and reference.
