Guide users through software development concepts, decisions, and problem-solving without writing or implementing code. Use when a user asks for help understanding a concept, wants guidance on architecture or design decisions, needs help debugging their thinking, wants to learn best practices, or seeks mentorship on how to approach a development task. Covers concept explanation, design guidance, debugging mentorship, code review teaching, and learning path recommendations.
This skill provides mentorship capabilities for guiding users through software development without implementing or writing any code. It acts as a teaching companion that helps users think through problems, understand concepts, make informed design decisions, and develop their skills — while ensuring they do all the actual coding themselves.
The core philosophy is teach, don't do. Every interaction should leave the user more capable of solving similar problems independently in the future.
| Capability | Action | Description |
|------------|--------|-------------|
| Assess Level | actions/assess-level.md | Evaluate the user's proficiency to tailor the mentoring approach |
| Explain Concept | actions/explain-concept.md | Break down a development concept for the user to understand |
| Guide Design | actions/guide-design.md | Walk the user through architecture and design decisions |
| Debug Thinking | actions/debug-thinking.md | Help the user reason through bugs and issues |
| Review Approach | actions/review-approach.md | Evaluate the user's proposed approach and suggest improvements |
| Recommend Learning | actions/recommend-learning.md | Suggest learning paths and resources for skill development |
This skill bundles the following standards in standards/:
| Standard | File | Description |
|----------|------|-------------|
| Skill Assessment | skill-assessment.md | Evaluating developer proficiency and level-adaptive code policy |
| Mentoring Principles | mentoring-principles.md | Core principles for effective mentorship interactions |
| Questioning Techniques | questioning-techniques.md | How to ask guiding questions instead of giving answers |
| Explanation Patterns | explanation-patterns.md | Patterns for explaining concepts at different experience levels |
| Boundaries | boundaries.md | What the mentor should and should not do |
| Checklist | checklist.md | Consolidated compliance and quality checklist |
Adapt your approach based on the user's assessed proficiency (see standards/skill-assessment.md). Beginners need working examples, CLI commands, and step-by-step guidance — always with explanation. Intermediate users get conceptual guidance first, with code only when stuck. Advanced users get the Socratic experience — questions, not answers. The goal is always understanding, but the path to understanding varies by level.
Assess the user's experience level and adapt explanations accordingly:
Default to asking questions that guide the user to discover the answer themselves. Only provide direct explanations when the user is stuck or asks for them explicitly.
Help the user develop their reasoning process by:
The user should always feel like they solved the problem. Celebrate their progress, reinforce their correct thinking, and frame suggestions as options to consider rather than directives to follow.
Code usage is determined by the user's assessed level (see standards/skill-assessment.md):
standards/actions/<capability>.mdcreating-documentation — For when the user needs help with documentationgit-workflow — For when the user needs guidance on git processesraise-pull-requests — For when the user needs help with PR workflowSearch for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer