aiskillstore/marketplace / skills/89jobrien/developer-experience
developer-experience
VerifiedDeveloper Experience specialist for tooling, setup, and workflow optimization. Use when setting up projects, reducing friction, improving development workflows, or automating repetitive tasks. Focuses on making development joyful and productive.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.1 KB |
| references/onboarding-guide.template.md | markdown | 3.8 KB |
| skill-report.json | config | 33.0 KB |
references/onboarding-guide.template.md
View on GitHub---
author: Joseph OBrien
status: unpublished
updated: '2025-12-23'
version: 1.0.1
tag: skill
type: reference
parent: developer-experience
---
# Developer Onboarding Guide
**Project:** {{PROJECT_NAME}}
**Last Updated:** {{DATE}}
**Version:** {{VERSION}}
---
## Welcome
{{BRIEF_PROJECT_DESCRIPTION}}
### Quick Links
| Resource | Link |
|----------|------|
| Repository | {{REPO_URL}} |
| Documentation | {{DOCS_URL}} |
| Issue Tracker | {{ISSUES_URL}} |
| CI/CD | {{CI_URL}} |
| Slack/Discord | {{CHAT_URL}} |
---
## Day 1: Environment Setup
### Prerequisites
- [ ] {{PREREQUISITE_1}} (version {{VERSION}})
- [ ] {{PREREQUISITE_2}}
- [ ] Access to {{SYSTEM}}
### Clone & Install
```bash
git clone {{REPO_URL}}
cd {{PROJECT_NAME}}
{{INSTALL_COMMAND}}
```
### Environment Variables
Copy the example environment file:
```bash
cp .env.example .env
```
Required variables:
| Variable | Description | How to Get |
|----------|-------------|------------|
| `{{VAR_1}}` | {{DESC}} | {{INSTRUCTIONS}} |
| `{{VAR_2}}` | {{DESC}} | {{INSTRUCTIONS}} |
### Verify Setup
```bash
{{VERIFY_COMMAND}}
```
Expected output:
```
{{EXPECTED_OUTPUT}}
```
---
## Day 2: Codebase Orientation
### Project Structure
```
{{PROJECT_NAME}}/
├── {{DIR_1}}/ # {{DESCRIPTION}}
├── {{DIR_2}}/ # {{DESCRIPTION}}
├── {{DIR_3}}/ # {{DESCRIPTION}}
└── {{CONFIG_FILE}} # {{DESCRIPTION}}
```
### Key Files
| File | Purpose |
|------|---------|
| `{{FILE_1}}` | {{PURPOSE}} |
| `{{FILE_2}}` | {{PURPOSE}} |
### Architecture Overview
{{ARCHITECTURE_DESCRIPTION}}
```
{{ARCHITECTURE_DIAGRAM}}
```
---
## Day 3: Development Workflow
### Running Locally
```bash
{{DEV_COMMAND}}
```
Access at: `http://localhost:{{PORT}}`
### Running Tests
```bash
{{TEST_COMMAND}}
```
### Code Style
We use {{LINTER/FORMATTER}}:
```bash
{{LINT_COMMAND}}
{{FORMAT_COMMAND}}
```
### Git Workflow
1. Create branch: `{{BRANCH_NAMING_CONVENTION}}`
2. Make changes
3. Run tests: `{{TEST_COMMAND}}`
4. Commit: Follow [Conventional Commits]({{COMMIT_GUIDE_URL}})
5. Push and create PR
---
## Week 1: First Tasks
### Starter Tasks
Good first issues to tackle:
1. {{STARTER_TASK_1}}
2. {{STARTER_TASK_2}}
3. {{STARTER_TASK_3}}
### Code Review Process
1. Create PR with description
2. Request review from {{REVIEWER}}
3. Address feedback
4. Merge when approved
---
## Key Concepts
### {{CONCEPT_1}}
{{EXPLANATION}}
### {{CONCEPT_2}}
{{EXPLANATION}}
### {{CONCEPT_3}}
{{EXPLANATION}}
---
## Common Tasks
### Adding a New {{COMPONENT}}
1. {{STEP_1}}
2. {{STEP_2}}
3. {{STEP_3}}
### Debugging
```bash
{{DEBUG_COMMAND}}
```
### Database Operations
```bash
{{DB_COMMAND}}
```
---
## Troubleshooting
### {{COMMON_ISSUE_1}}
**Symptom:** {{SYMPTOM}}
**Solution:**
```bash
{{SOLUTION}}
```
### {{COMMON_ISSUE_2}}
**Symptom:** {{SYMPTOM}}
**Solution:** {{SOLUTION}}
---
## Team & Communication
### Key Contacts
| Role | Name | Contact |
|------|------|---------|
| Tech Lead | {{NAME}} | {{CONTACT}} |
| Product | {{NAME}} | {{CONTACT}} |
### Meetings
| Meeting | Frequency | Time |
|---------|-----------|------|
| Standup | Daily | {{TIME}} |
| Sprint Planning | {{FREQ}} | {{TIME}} |
### Communication Norms
- {{NORM_1}}
- {{NORM_2}}
---
## Resources
### Documentation
- [{{DOC_1}}]({{URL}})
- [{{DOC_2}}]({{URL}})
### Learning Resources
- {{RESOURCE_1}}
- {{RESOURCE_2}}
---
## Checklist
### Setup Complete
- [ ] Repository cloned
- [ ] Dependencies installed
- [ ] Environment configured
- [ ] Application runs locally
- [ ] Tests pass
### Orientation Complete
- [ ] Codebase structure understood
- [ ] Key files reviewed
- [ ] Architecture overview read
- [ ] First PR submitted
### Fully Onboarded
- [ ] Completed first task independently
- [ ] Participated in code review
- [ ] Attended team meetings
- [ ] Questions answered
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |