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 |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-09T14:20:17.488Z",
"slug": "89jobrien-developer-experience",
"source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/developer-experience",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "20a466d656266fdb0209d65a7bd9954a3a8794e74de6dc5f9d03ae5738d3d6d1",
"tree_hash": "735c1c54094ed59e7a94b8c3350c2d926d84c5afab19cca2135b2833236dd2aa",
"provenance": {
"model_requested": "gpt-5.5:high",
"model_effective": "codex:gpt-5.5:high",
"fallback_chain": [
{
"agent": "codex",
"model": "gpt-5.5",
"effort": "high",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "developer-experience",
"description": "Guides developer environment setup, workflow automation, onboarding documentation, editor tooling, git hooks, and command shortcuts for software projects.",
"summary": "Improves project setup, developer workflows, tooling, and onboarding documentation.",
"icon": "📦",
"version": "1.0.1",
"author": "Joseph OBrien",
"license": "MIT",
"tags": [
"developer-experience",
"workflow-automation",
"onboarding",
"tooling",
"dev-environments"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"external_commands",
"filesystem"
],
"category": "coding"
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"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.",
"remediation": [
{
"issue": "Environment setup examples can be copied into real projects without review.",
"suggestion": "Tell users to inspect generated .env files and avoid committing secrets after copying templates.",
"severity": "low"
},
{
"issue": "Optional shell profile alias examples mention ~/.zshrc and ~/.bashrc.",
"suggestion": "Ask users to review, back up, and approve shell profile edits before applying aliases.",
"severity": "low"
}
],
"risk_factor_evidence": [
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 40,
"line_end": 42
},
{
"file": "SKILL.md",
"line_start": 42,
"line_end": 44
},
{
"file": "SKILL.md",
"line_start": 44,
"line_end": 46
},
{
"file": "SKILL.md",
"line_start": 46,
"line_end": 50
},
{
"file": "SKILL.md",
"line_start": 50,
"line_end": 52
},
{
"file": "SKILL.md",
"line_start": 52,
"line_end": 54
},
{
"file": "SKILL.md",
"line_start": 54,
"line_end": 56
},
{
"file": "SKILL.md",
"line_start": 56,
"line_end": 128
},
{
"file": "SKILL.md",
"line_start": 128,
"line_end": 140
},
{
"file": "SKILL.md",
"line_start": 140,
"line_end": 162
},
{
"file": "SKILL.md",
"line_start": 162,
"line_end": 166
},
{
"file": "SKILL.md",
"line_start": 166,
"line_end": 181
},
{
"file": "SKILL.md",
"line_start": 181,
"line_end": 185
},
{
"file": "SKILL.md",
"line_start": 185,
"line_end": 190
},
{
"file": "SKILL.md",
"line_start": 190,
"line_end": 198
},
{
"file": "SKILL.md",
"line_start": 198,
"line_end": 202
},
{
"file": "SKILL.md",
"line_start": 202,
"line_end": 226
},
{
"file": "SKILL.md",
"line_start": 226,
"line_end": 230
},
{
"file": "SKILL.md",
"line_start": 230,
"line_end": 236
},
{
"file": "SKILL.md",
"line_start": 236,
"line_end": 240
},
{
"file": "SKILL.md",
"line_start": 240,
"line_end": 260
},
{
"file": "SKILL.md",
"line_start": 260,
"line_end": 262
},
{
"file": "SKILL.md",
"line_start": 262,
"line_end": 303
},
{
"file": "SKILL.md",
"line_start": 146,
"line_end": 146
},
{
"file": "SKILL.md",
"line_start": 140,
"line_end": 162
},
{
"file": "SKILL.md",
"line_start": 141,
"line_end": 141
},
{
"file": "SKILL.md",
"line_start": 187,
"line_end": 187
}
]
},
{
"factor": "filesystem",
"evidence": [
{
"file": "SKILL.md",
"line_start": 231,
"line_end": 231
},
{
"file": "SKILL.md",
"line_start": 231,
"line_end": 231
}
]
}
],
"static_findings": [
{
"id": "sensitive:references/onboarding-guide.template.md:56:environment-file-access",
"category": "sensitive",
"severity": "high",
"pattern": "Environment file access",
"file": "references/onboarding-guide.template.md",
"line_start": 56,
"line_end": 56,
"snippet": "cp .env.example .env"
},
{
"id": "blocker:references/onboarding-guide.template.md:41:template-injection-targeting-system-prompt",
"category": "blocker",
"severity": "medium",
"pattern": "Template injection targeting system prompt",
"file": "references/onboarding-guide.template.md",
"line_start": 41,
"line_end": 41,
"snippet": "- [ ] Access to {{SYSTEM}}"
},
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 40,
"line_end": 42,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 42,
"line_end": 44,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 44,
"line_end": 46,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 46,
"line_end": 50,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 50,
"line_end": 52,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 52,
"line_end": 54,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 54,
"line_end": 56,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 56,
"line_end": 128,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:128:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 128,
"line_end": 140,
"snippet": "```markdown"
},
{
"id": "external_commands:SKILL.md:140:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 140,
"line_end": 162,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 162,
"line_end": 166,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 166,
"line_end": 181,
"snippet": "```json"
},
{
"id": "external_commands:SKILL.md:181:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 181,
"line_end": 185,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:185:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 185,
"line_end": 190,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:190:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 190,
"line_end": 198,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:198:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 198,
"line_end": 202,
"snippet": "```markdown"
},
{
"id": "external_commands:SKILL.md:202:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 202,
"line_end": 226,
"snippet": "```makefile"
},
{
"id": "external_commands:SKILL.md:226:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 226,
"line_end": 230,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:230:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 230,
"line_end": 236,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:236:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 236,
"line_end": 240,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:240:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 240,
"line_end": 260,
"snippet": "```json"
},
{
"id": "external_commands:SKILL.md:260:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 260,
"line_end": 262,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:262:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 262,
"line_end": 303,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:146:shell-command-substitution",
"category": "external_commands",
"severity": "medium",
"pattern": "Shell command substitution",
"file": "SKILL.md",
"line_start": 146,
"line_end": 146,
"snippet": "node_version=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)"
},
{
"id": "external_commands:SKILL.md:140:template-literal-with-command-substitution",
"category": "external_commands",
"severity": "medium",
"pattern": "Template literal with command substitution",
"file": "SKILL.md",
"line_start": 140,
"line_end": 162,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:141:unix-shell-invocation",
"category": "external_commands",
"severity": "medium",
"pattern": "Unix shell invocation",
"file": "SKILL.md",
"line_start": 141,
"line_end": 141,
"snippet": "#!/bin/bash"
},
{
"id": "external_commands:SKILL.md:187:unix-shell-invocation",
"category": "external_commands",
"severity": "medium",
"pattern": "Unix shell invocation",
"file": "SKILL.md",
"line_start": 187,
"line_end": 187,
"snippet": "#!/bin/sh"
},
{
"id": "filesystem:SKILL.md:231:hidden-file-in-home-directory",
"category": "filesystem",
"severity": "high",
"pattern": "Hidden file in home directory",
"file": "SKILL.md",
"line_start": 231,
"line_end": 231,
"snippet": "# Add to ~/.zshrc or ~/.bashrc"
},
{
"id": "filesystem:SKILL.md:231:hidden-file-access",
"category": "filesystem",
"severity": "medium",
"pattern": "Hidden file access",
"file": "SKILL.md",
"line_start": 231,
"line_end": 231,
"snippet": "# Add to ~/.zshrc or ~/.bashrc"
},
{
"id": "sensitive:SKILL.md:156:environment-file-access",
"category": "sensitive",
"severity": "high",
"pattern": "Environment file access",
"file": "SKILL.md",
"line_start": 156,
"line_end": 156,
"snippet": "cp .env.example .env"
}
],
"finding_verdicts": [
{
"id": "sensitive:references/onboarding-guide.template.md:56:environment-file-access",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The line copies .env.example to .env inside an onboarding template. It does not read, transmit, or expose real environment secrets."
},
{
"id": "blocker:references/onboarding-guide.template.md:41:template-injection-targeting-system-prompt",
"verdict": "false_positive",
"confidence": 0.92,
"reason": "The {{SYSTEM}} token is a project access placeholder in a checklist. It is not an instruction to target the assistant system prompt or override policy."
},
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is a Markdown code fence around a sample prompt. It is not Ruby backtick execution or an executable shell command."
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is a Markdown code fence around a sample prompt. It is not Ruby backtick execution or an executable shell command."
},
{
"id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is a Markdown code fence around a sample prompt. It is not Ruby backtick execution or an executable shell command."
},
{
"id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is a Markdown code fence around a sample prompt. It is not Ruby backtick execution or an executable shell command."
},
{
"id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is a Markdown code fence around a sample prompt. It is not Ruby backtick execution or an executable shell command."
},
{
"id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is a Markdown code fence around a sample prompt. It is not Ruby backtick execution or an executable shell command."
},
{
"id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is a Markdown code fence around a sample prompt. It is not Ruby backtick execution or an executable shell command."
},
{
"id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This is Markdown documentation text, and the detected token is a fence delimiter. There is no hidden interpreter invocation or automatic command execution."
},
{
"id": "external_commands:SKILL.md:128:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This opens a Markdown example block for a generated setup guide. It is documentation content, not Ruby backtick execution."
},
{
"id": "external_commands:SKILL.md:140:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "This is the start of a bash example inside documentation. The commands are visible setup-script examples, not hidden execution by the skill itself."
},
{
"id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This is a Markdown code fence closing an example block. It is not an executable backtick expression."
},
{
"id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This opens a JSON example for package scripts. The backticks are Markdown syntax, not a shell execution primitive."
},
{
"id": "external_commands:SKILL.md:181:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This is a Markdown fence closing the package script example. It does not execute a command."
},
{
"id": "external_commands:SKILL.md:185:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "This opens a visible bash example for a pre-commit hook. It is documentation for common project tooling, not covert command execution."
},
{
"id": "external_commands:SKILL.md:190:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This is a Markdown code fence closing the hook example. It is not Ruby or shell backtick execution."
},
{
"id": "external_commands:SKILL.md:198:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This opens a Markdown example block for workflow shortcuts. It is documentation content, not an executable command."
},
{
"id": "external_commands:SKILL.md:202:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "This opens a Makefile example with explicit local development tasks. The content is visible project automation guidance, not hidden command execution."
},
{
"id": "external_commands:SKILL.md:226:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This is a Markdown code fence closing the Makefile example. It is not an executable backtick expression."
},
{
"id": "external_commands:SKILL.md:230:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "This opens a bash example for optional shell aliases. The aliases are visible shortcuts for npm commands and are not automatic persistence or exfiltration."
},
{
"id": "external_commands:SKILL.md:236:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This is a Markdown code fence closing the alias example. It is not shell execution."
},
{
"id": "external_commands:SKILL.md:240:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "This opens a VS Code tasks JSON example. It documents editor task configuration and does not execute by itself."
},
{
"id": "external_commands:SKILL.md:260:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This is a Markdown code fence closing the VS Code task example. It is not Ruby backtick execution."
},
{
"id": "external_commands:SKILL.md:262:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This is a Markdown fence closing the larger example output block. It is not an executable command."
},
{
"id": "external_commands:SKILL.md:146:shell-command-substitution",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "The command substitution reads the local Node.js version in a sample setup script. It does not consume user-controlled input or send data externally."
},
{
"id": "external_commands:SKILL.md:140:template-literal-with-command-substitution",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The flagged region is a documented bash setup-script example. Its command substitution is limited to checking node -v and is not an injection sink."
},
{
"id": "external_commands:SKILL.md:141:unix-shell-invocation",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The shebang appears in a visible sample setup script. It is normal documentation for a script the user may choose to create, not automatic execution."
},
{
"id": "external_commands:SKILL.md:187:unix-shell-invocation",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The shebang appears in a visible sample git hook. It runs only if a user installs the hook and contains ordinary lint and test commands."
},
{
"id": "filesystem:SKILL.md:231:hidden-file-in-home-directory",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "The line is a comment explaining where optional shell aliases may be placed. The example aliases are benign npm shortcuts and the skill does not modify hidden files automatically."
},
{
"id": "filesystem:SKILL.md:231:hidden-file-access",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "The line references shell profile files as optional configuration locations. There is no automatic read or write of hidden files in the skill content."
},
{
"id": "sensitive:SKILL.md:156:environment-file-access",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The example copies .env.example to .env during local setup. It does not inspect existing secrets or exfiltrate environment data."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 2,
"total_lines": 594,
"audit_model": "codex",
"audited_at": "2026-07-09T14:20:17.488Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Improve Developer Workflows",
"value_statement": "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.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"developer experience",
"workflow automation",
"project setup",
"developer onboarding",
"git hooks",
"VS Code tasks",
"setup scripts"
],
"actual_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."
],
"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."
],
"use_cases": [
{
"title": "Speed Up New Project Setup",
"description": "Create a clear setup path with prerequisites, install steps, environment templates, and verification checks.",
"target_user": "Startup engineer"
},
{
"title": "Improve Team Onboarding",
"description": "Build an onboarding guide that explains access, project structure, workflow expectations, and first-week tasks.",
"target_user": "Engineering manager"
},
{
"title": "Reduce Repeated Local Tasks",
"description": "Identify repeated commands and convert them into package scripts, Makefile tasks, editor tasks, or safe aliases.",
"target_user": "Platform engineer"
}
],
"prompt_templates": [
{
"title": "Review Setup Friction",
"scenario": "Beginner review of a project setup flow.",
"prompt": "Review this repository setup process. List the steps that may block a new developer and suggest clear improvements."
},
{
"title": "Create Onboarding Guide",
"scenario": "Structured documentation for new contributors.",
"prompt": "Create an onboarding guide for this project with prerequisites, access needs, install steps, verification checks, and troubleshooting notes."
},
{
"title": "Design Workflow Automation",
"scenario": "Intermediate automation planning for repeated development tasks.",
"prompt": "Analyze common development tasks in this project. Recommend package scripts, Makefile tasks, git hooks, and editor tasks with safety notes."
},
{
"title": "Optimize Developer Feedback Loops",
"scenario": "Advanced review of build, test, lint, and local development speed.",
"prompt": "Audit the developer feedback loop for this repository. Prioritize changes that reduce setup time, test time, build time, and manual coordination."
}
],
"output_examples": [
{
"input": "Review our setup process for a Node.js project.",
"output": [
"A setup audit that identifies missing version checks, unclear environment steps, and manual dependency work.",
"A prioritized improvement list with setup validation, clearer documentation, and safer first-run commands."
]
},
{
"input": "Create onboarding material for a new backend engineer.",
"output": [
"A day-by-day onboarding outline covering access, local setup, project structure, test workflow, and troubleshooting.",
"A checklist that separates required access, optional tools, and first contribution tasks."
]
},
{
"input": "Find ways to reduce repeated local commands.",
"output": [
"A workflow plan that groups repeated tasks into package scripts, editor tasks, and project shortcuts.",
"Safety notes for commands that touch environment files, shell profiles, or generated build output."
]
}
],
"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."
],
"faq": [
{
"question": "What does this skill help with?",
"answer": "It helps improve project setup, onboarding, local workflows, editor tooling, git hooks, and repeated development tasks."
},
{
"question": "Can it write setup scripts?",
"answer": "Yes. It can propose setup scripts and commands, but users should review them before running anything."
},
{
"question": "Does it work with Claude, Codex, and Claude Code?",
"answer": "Yes. The report lists support for Claude, Codex, and Claude Code."
},
{
"question": "Can it improve onboarding documentation?",
"answer": "Yes. It can structure onboarding guides with prerequisites, access needs, verification steps, and troubleshooting notes."
},
{
"question": "Will it automatically change my shell profile?",
"answer": "No. It may suggest aliases, but profile changes should only happen after explicit user review and approval."
},
{
"question": "What should teams provide for best results?",
"answer": "Provide the current README, package scripts, tool versions, common setup failures, and team workflow expectations."
}
]
},
"file_structure": [
{
"name": "references",
"type": "dir",
"path": "references",
"children": [
{
"name": "onboarding-guide.template.md",
"type": "file",
"path": "references/onboarding-guide.template.md",
"lines": 281
}
]
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 313
}
]
}
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 |