nexu-io/open-design / .claude/skills/od-contribute
od-contribute
UnverifiedOne-click contribution flow for OpenDesign (nexu-io/open-design) — even for non-coders. Pick one of four cards (ship a Skill or Design System you made with OD; translate docs; fix a typo / write a blog; report a bug), the agent validates and opens a PR (or issue) for you. Trigger words contribute to open design, ship my OD skill, ship my OD design system, translate OD docs, report an OD bug, od-contribute.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.8 KB |
| agents/openai.yaml | config | 650 B |
| install.shexecutable | script | 5.1 KB |
| references/design-system-anatomy.md | markdown | 2.0 KB |
| references/newcomer-tone.md | markdown | 2.7 KB |
| references/od-repo-map.md | markdown | 2.2 KB |
| references/skill-anatomy.md | markdown | 2.3 KB |
| scripts/check-prereqs.shexecutable | script | 4.1 KB |
| scripts/config.shexecutable | script | 2.4 KB |
| scripts/create-issue.shexecutable | script | 3.7 KB |
| scripts/create-pr.shexecutable | script | 3.8 KB |
| scripts/discover-doc-gaps.shexecutable | script | 4.0 KB |
| scripts/discover-i18n-gaps.shexecutable | script | 4.8 KB |
| scripts/setup-workspace.shexecutable | script | 3.4 KB |
| scripts/validate-design-system.shexecutable | script | 3.3 KB |
| scripts/validate-markdown.shexecutable | script | 6.9 KB |
| scripts/validate-skill-submission.shexecutable | script | 5.0 KB |
| templates/ISSUE-BODY-bug.md | markdown | 450 B |
| templates/PR-BODY-design-system.md | markdown | 1.1 KB |
| templates/PR-BODY-docs.md | markdown | 723 B |
| templates/PR-BODY-i18n.md | markdown | 1.2 KB |
| templates/PR-BODY-skill.md | markdown | 1016 B |
scripts/setup-workspace.sh
View on GitHub#!/usr/bin/env bash
# Clone (or reuse) nexu-io/open-design in an isolated workdir + create a feature branch.
# Usage: setup-workspace.sh <type> <slug>
# <type> one of: skill | design-system | i18n | docs
# <slug> short kebab-case identifier (e.g. "translate-readme-es", "fix-typo-quickstart")
#
# Env: TARGET_FORK optional (else pushes go to upstream — create-pr.sh warns first).
#
# Stdout (machine-readable):
# WORKDIR=<abs path>
# BRANCH=<branch name>
set -euo pipefail
source "$(dirname "$0")/config.sh"
TYPE="${1:?type required (skill|design-system|i18n|docs)}"
SLUG="${2:?slug required}"
case "$TYPE" in
skill|design-system|i18n|docs) ;;
*) od::die "unknown type: $TYPE (expected skill|design-system|i18n|docs)" ;;
esac
od::require gh
od::require git
# Use second-precision timestamp so two contribution sessions on the same day
# (or the SKILL.md i18n flow that calls setup-workspace.sh with a placeholder
# slug like "translate" before the user has picked a language) don't collide
# into the same workdir. Reusing a workdir would leak untracked / half-edited
# files from an earlier abandoned session into a later contribution.
SESSION_TAG="$(date +%Y%m%d-%H%M%S)"
SESSION_DIR="${TYPE}-${SLUG}-${SESSION_TAG}"
WORKDIR="$(od::workdir_for "$SESSION_DIR")"
BRANCH="od-contrib/${TYPE}/${SLUG}-${SESSION_TAG}"
mkdir -p "$OD_WORK_ROOT"
od::assert_in_workroot "$WORKDIR"
CLONE_URL="https://github.com/${TARGET_REPO}.git"
if [[ -d "$WORKDIR/.git" ]]; then
# We reach here only if the user explicitly resumed by passing the same
# SESSION_TAG, or if the wall clock somehow produced a duplicate. Clean any
# untracked/dirty state so the run starts from a known good base instead of
# inheriting whatever the previous occupant left behind.
od::log "reusing existing workdir: $WORKDIR"
git -C "$WORKDIR" fetch origin --prune
git -C "$WORKDIR" reset --hard HEAD
git -C "$WORKDIR" clean -fdx
else
od::log "cloning $CLONE_URL → $WORKDIR (depth 50)"
git clone --depth 50 "$CLONE_URL" "$WORKDIR"
fi
# Tell git to ignore our internal scratch dir so `git add -A` later (in
# create-pr.sh) doesn't accidentally stage type.txt, slug.txt, PR-BODY.md
# into the user's contribution PR. .git/info/exclude is repo-local and not
# committed, so we don't pollute the OD repo's .gitignore.
mkdir -p "$WORKDIR/.git/info"
if ! grep -qxF '.od-contrib/' "$WORKDIR/.git/info/exclude" 2>/dev/null; then
printf '\n# od-contribute scratch dir (added by setup-workspace.sh)\n.od-contrib/\n' \
>> "$WORKDIR/.git/info/exclude"
fi
git -C "$WORKDIR" checkout "$OD_BASE_BRANCH"
git -C "$WORKDIR" pull --ff-only origin "$OD_BASE_BRANCH"
# Configure fork remote if provided.
if [[ -n "${TARGET_FORK}" ]]; then
if git -C "$WORKDIR" remote | grep -q '^fork$'; then
git -C "$WORKDIR" remote set-url fork "https://github.com/${TARGET_FORK}.git"
else
git -C "$WORKDIR" remote add fork "https://github.com/${TARGET_FORK}.git"
fi
fi
# Create or reset branch off latest base.
if git -C "$WORKDIR" show-ref --verify --quiet "refs/heads/$BRANCH"; then
od::log "branch $BRANCH already exists — switching"
git -C "$WORKDIR" checkout "$BRANCH"
else
git -C "$WORKDIR" checkout -b "$BRANCH" "$OD_BASE_BRANCH"
fi
mkdir -p "$WORKDIR/.od-contrib"
printf '%s\n' "$TYPE" > "$WORKDIR/.od-contrib/type.txt"
printf '%s\n' "$SLUG" > "$WORKDIR/.od-contrib/slug.txt"
od::log "workspace ready"
printf 'WORKDIR=%s\n' "$WORKDIR"
printf 'BRANCH=%s\n' "$BRANCH"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |