# Synthcad Setup Github Project

> Set up GitHub repository, Actions CI review, project-local tests, artifacts, and branch protection for SynthCAD CAD projects.

- **Type:** Skill
- **Install:** `agentstack add skill-bencaunt-synthcad-synthcad-setup-github-project`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [BenCaunt](https://agentstack.voostack.com/s/bencaunt)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [BenCaunt](https://github.com/BenCaunt)
- **Source:** https://github.com/BenCaunt/SynthCAD/tree/main/skills/synthcad-setup-github-project

## Install

```sh
agentstack add skill-bencaunt-synthcad-synthcad-setup-github-project
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# SynthCAD GitHub Project Setup

Use this skill when asked to prepare a SynthCAD repository for GitHub-based
collaboration, pull-request review, or CI validation.

## Setup Workflow

1. Confirm the intended repository, default branch, and visibility.
2. Check local git status before editing or pushing.
3. Add or update a GitHub Actions CAD review workflow under
   `.github/workflows/`.
4. Make CI produce reviewable artifacts and PR review links, not just pass/fail
   logs:
   generated CAD exports, inspection reports, interference overlays, URDF
   packages, a Markdown summary in `$GITHUB_STEP_SUMMARY`, a static PR diff
   viewer, and an upserted PR comment linking to the viewer and workflow run.
5. Ensure every CAD project has tests under `projects//tests/`
   and that CI runs both root tests and project-local tests.
6. Keep `projects/*/generated/`, BREP caches, virtualenvs, and build outputs
   ignored.
7. Run the local checks that mirror CI before committing.
8. Push intentionally and, for nontrivial changes, open a PR rather than
   pushing directly to the protected default branch.

## Commands

Set the project variables from `uv run synthcad-build --list` and the current
repo's build registry:

```bash
gh auth status
gh repo view --json nameWithOwner,visibility,defaultBranchRef
git status --short --ignored
uv run synthcad-build --list
PROJECT=
ASSEMBLY_TARGET=
URDF_TARGET=
uv run python -m compileall -q -f main.py synthcad tests projects
uv run pytest
uv run pytest "projects/$PROJECT/tests"
uv run synthcad-build --project "$PROJECT" --profile
uv run synthcad-inspect --target "$ASSEMBLY_TARGET" --interference all
uv run show-interference --target "$ASSEMBLY_TARGET"
uv run synthcad-report --project "$PROJECT"
test -z "$URDF_TARGET" || uv run synthcad-urdf --target "$URDF_TARGET"
```

Use the local `readline` shim for pytest if the local uv Python crashes before
collection:

```bash
uv run python - <<'PY'
import sys
import types
sys.modules["readline"] = types.ModuleType("readline")
import pytest
raise SystemExit(pytest.main(["-q"]))
PY
```

## CI Review Pattern

Read `references/github-ci-review.md` when creating or changing the workflow.
It includes the expected Actions shape, artifact policy,
PR visualization/comment policy, branch protection checklist, and reusable
workflow template at `references/synthcad-ci-template.yml`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [BenCaunt](https://github.com/BenCaunt)
- **Source:** [BenCaunt/SynthCAD](https://github.com/BenCaunt/SynthCAD)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-bencaunt-synthcad-synthcad-setup-github-project
- Seller: https://agentstack.voostack.com/s/bencaunt
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.