Skip to content

nexu-io/open-design / .claude/skills/od-contribute

od-contribute

Unverified

One-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.

FileKindSize
SKILL.mdskill md13.8 KB
agents/openai.yamlconfig650 B
install.shexecutablescript5.1 KB
references/design-system-anatomy.mdmarkdown2.0 KB
references/newcomer-tone.mdmarkdown2.7 KB
references/od-repo-map.mdmarkdown2.2 KB
references/skill-anatomy.mdmarkdown2.3 KB
scripts/check-prereqs.shexecutablescript4.1 KB
scripts/config.shexecutablescript2.4 KB
scripts/create-issue.shexecutablescript3.7 KB
scripts/create-pr.shexecutablescript3.8 KB
scripts/discover-doc-gaps.shexecutablescript4.0 KB
scripts/discover-i18n-gaps.shexecutablescript4.8 KB
scripts/setup-workspace.shexecutablescript3.4 KB
scripts/validate-design-system.shexecutablescript3.3 KB
scripts/validate-markdown.shexecutablescript6.9 KB
scripts/validate-skill-submission.shexecutablescript5.0 KB
templates/ISSUE-BODY-bug.mdmarkdown450 B
templates/PR-BODY-design-system.mdmarkdown1.1 KB
templates/PR-BODY-docs.mdmarkdown723 B
templates/PR-BODY-i18n.mdmarkdown1.2 KB
templates/PR-BODY-skill.mdmarkdown1016 B

scripts/config.sh

View on GitHub
#!/usr/bin/env bash
# Shared config for the od-contribute skill.
# TARGET_REPO is hard-locked to nexu-io/open-design — this skill is OD-specific.
#
# Override via env vars before invoking a script:
#   TARGET_FORK   "<owner>/<name>"  push branches here. Defaults to $GH_USER/open-design at runtime.
#   OD_BASE_BRANCH                   default: main
#   OD_WORK_ROOT                     default: $HOME/od-contrib-work
#   OD_DISCORD_INVITE                default: https://discord.gg/qhbcCH8Am4

set -euo pipefail

readonly OD_TARGET_REPO="nexu-io/open-design"
TARGET_REPO="$OD_TARGET_REPO"

: "${TARGET_FORK:=}"
: "${OD_BASE_BRANCH:=main}"
: "${OD_WORK_ROOT:="$HOME/od-contrib-work"}"
: "${OD_DISCORD_INVITE:=https://discord.gg/qhbcCH8Am4}"

# Sandboxed-agent fallback for gh auth.
# Codex.app, Cursor, and other macOS App Sandbox runtimes can't reach the
# system keychain where `gh auth login` stores the token by default. If
# GH_TOKEN isn't already set in the env, look for a token file shipped
# alongside the skill. The skill never *creates* this file automatically —
# it must be written by either:
#   - a one-time `gh auth token > <skill>/.gh-token` from a non-sandboxed shell, or
#   - the OAuth Device Flow bootstrap (TODO: implement for non-coder users).
_OD_SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
if [[ -z "${GH_TOKEN:-}" && -f "$_OD_SKILL_DIR/.gh-token" ]]; then
  GH_TOKEN="$(tr -d '[:space:]' < "$_OD_SKILL_DIR/.gh-token")"
  export GH_TOKEN
fi
unset _OD_SKILL_DIR

export TARGET_REPO TARGET_FORK OD_BASE_BRANCH OD_WORK_ROOT OD_DISCORD_INVITE

od::log()  { printf '[od-contrib] %s\n' "$*" >&2; }
od::warn() { printf '[od-contrib][warn] %s\n' "$*" >&2; }
od::err()  { printf '[od-contrib][error] %s\n' "$*" >&2; }
od::die()  { od::err "$*"; exit 1; }

od::require() {
  command -v "$1" >/dev/null 2>&1 || od::die "missing dependency: $1"
}

od::slugify() {
  local s="${1:-}"
  s="$(printf '%s' "$s" | tr '[:upper:]' '[:lower:]')"
  s="$(printf '%s' "$s" | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//')"
  printf '%s' "${s:0:48}"
}

od::workdir_for() {
  # $1 = a slug for this contribution session (e.g. "skill-foo-2026-05-28")
  printf '%s/%s\n' "$OD_WORK_ROOT" "$1"
}

# Refuse to operate outside $OD_WORK_ROOT (defense against runaway scripts).
od::assert_in_workroot() {
  local path="$1"
  case "$path" in
    "$OD_WORK_ROOT"/*) return 0 ;;
    *) od::die "refusing to operate on path outside OD_WORK_ROOT: $path" ;;
  esac
}
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall