From agentic-contributor
This skill should be used when the user asks to set up their local development environment for an open-source project. Trigger phrases include: "set up the project locally", "how do I clone and build X", "help me get the dev environment running", "how do I run the tests for X", "I can't get the build to work", "set up apache/airflow locally", "set up apache/spark locally", "what are the prerequisites for X".
How this skill is triggered — by the user, by Claude, or both
Slash command
/agentic-contributor:dev-env-setupThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
To guide a contributor through setting up their local development environment, follow these steps:
To guide a contributor through setting up their local development environment, follow these steps:
Locate and read the project's official setup documentation:
CONTRIBUTING.md / CONTRIBUTING.rst — look for "Development Setup", "Local Development",
or "Building from Source" sections.README.md — may contain a quick-start or prerequisites section.docs/ directory for deeper setup guides.Dockerfile, docker-compose.yml,
scripts/ci/ directories).Present the steps in order as extracted from the official docs. Do not improvise steps not in the documentation.
Before the user starts, flag any known heavy or finicky setup requirements:
Apache Airflow (Breeze):
Airflow uses its own Docker-based development environment called Breeze. Setup requires Docker Desktop (or a Docker daemon), and the initial image pull is several GB. First-time setup can take 15–30 minutes. The canonical entry point is
./scripts/ci/tools/breeze. Non-Breeze local setup is also documented but less supported for testing.
Apache Spark (JDK + Scala + SBT/Maven):
Spark requires a supported JDK (check the current CONTRIBUTING.md — typically JDK 8 or 11/17), Scala (usually installed via sbt), and either Maven or sbt for the build. The full build (
./build/mvn -DskipTests package) can take 10–30 minutes on first run. PySpark additionally requires a matching Python version.
For other projects, check CONTRIBUTING.md and surface any flagged prerequisites.
Guide the contributor to a verifiable checkpoint — the project's test suite or a smoke build:
pytest tests/unit/, ./gradlew test, mvn test -pl core -Dtest=SimpleTest).When a setup step fails:
If any step would make a destructive or global change (e.g., upgrading a system package, changing
$PATH permanently, removing existing virtual environments), present it as a confirmation step:
"The next step will [describe change]. Do you want to proceed? (yes/no)"
Proceed only after explicit confirmation.
This skill ends at a verified, ready development environment. The following are out of scope and belong to the separate execution/submission plugin:
State this boundary clearly if the user asks about next steps beyond environment setup.
Return the walkthrough to the orchestrating /oss command. The orchestrator saves it to
.oss-drafts/setup-<owner>-<repo>-setup-<UTC>.md and shows the user the file path with the
notice: "Saved to <path>. Review and edit this report file as needed before using it."
Structure the guidance as:
## Dev Environment Setup: <owner/repo>
### Prerequisites
<list of required tools, versions, and download links>
### Setup Steps
1. <step from official docs>
2. <step>
...
### Environment Ready Checkpoint
<command to run> → <expected success output>
### Known Pitfalls
<any flagged heavy setups or common failure modes>
npx claudepluginhub josix/agentic-contributor --plugin agentic-contributorCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.