# Improve Developer Workflows

Development setup often takes too long and leaves new contributors blocked. This skill helps Claude, Codex, and Claude Code design setup guides, scripts, shortcuts, and tooling improvements.

## Install

```bash
npx skillstore add joseph obrien/89jobrien-developer-experience
```

## Metadata

- Status: approved
- Slug: 89jobrien-developer-experience
- Version: 1.0.1
- Author version: 1.0.1
- Skillstore revision: r1
- Version status: valid
- Tree hash: 43e40e3535ef4d629c2fe27330a5fcdf1d8fd3cdde261a2b33c89e9ea655722f
- Author: Joseph OBrien
- GitHub username: 89jobrien
- License: MIT
- Repository: https://github.com/89jobrien/steve/tree/main/steve/skills/developer-experience
- Ref: 26421118b848d9f1efc0aa169d8a7a9e7e0a877e
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/89jobrien-developer-experience
- Manifest: https://skillstore.pages.dev/api/skills/89jobrien-developer-experience/manifest

## Capabilities

- Reviews project setup steps and identifies sources of developer friction.
- Suggests setup scripts, package commands, Makefile tasks, and shell aliases.
- Creates onboarding guide structure with prerequisites, access needs, and verification steps.
- Recommends editor configuration, linting, formatting, and debug task improvements.
- Designs git hook workflows for linting, tests, and commit quality checks.
- Documents troubleshooting steps and success metrics for developer workflows.

## Use Cases

- Speed Up New Project Setup: Create a clear setup path with prerequisites, install steps, environment templates, and verification checks.
- Improve Team Onboarding: Build an onboarding guide that explains access, project structure, workflow expectations, and first-week tasks.
- Reduce Repeated Local Tasks: Identify repeated commands and convert them into package scripts, Makefile tasks, editor tasks, or safe aliases.

## Prompt Templates

### Review Setup Friction

```
Review this repository setup process. List the steps that may block a new developer and suggest clear improvements.
```

### Create Onboarding Guide

```
Create an onboarding guide for this project with prerequisites, access needs, install steps, verification checks, and troubleshooting notes.
```

### Design Workflow Automation

```
Analyze common development tasks in this project. Recommend package scripts, Makefile tasks, git hooks, and editor tasks with safety notes.
```

### Optimize Developer Feedback Loops

```
Audit the developer feedback loop for this repository. Prioritize changes that reduce setup time, test time, build time, and manual coordination.
```

## Limitations

- Generated commands must be reviewed before they run on a real system.
- The skill does not know private project policies unless they are provided.
- It cannot guarantee every tool version or dependency is available locally.
- Shell, git hook, and environment file changes may need team approval.

## Best Practices

- Review every generated command before running it in a local or shared environment.
- Keep setup guidance project-specific, versioned, and tested by a new contributor.
- Prefer reversible automation with clear verification steps and helpful error messages.

## Anti Patterns

- Do not add shell profile changes without user approval and a backup plan.
- Do not hide required access, secrets, or manual setup steps inside vague instructions.
- Do not create automation that runs destructive cleanup commands without context.

## Security Audit

- Audited at: 2026-07-09T14:20:17.488\+00:00
- Summary: The static findings are documentation examples, Markdown fences, or onboarding placeholders rather than executable malicious behavior. No prompt injection, credential exfiltration, or covert persistence intent was found in SKILL.md or references/onboarding-guide.template.md. The skill should still advise users to review environment and shell profile changes before applying generated setup guidance.

## Stats

- Views: 239
- Downloads: 11
- Favorites: 1
- Popularity score: 0