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/validate-design-system.sh
View on GitHub#!/usr/bin/env bash
# Validate a user-supplied DESIGN.md (OpenDesign "design system" submission).
# Usage: validate-design-system.sh <DESIGN.md path> [--reference <existing-DESIGN.md>]
#
# Strategy: instead of hardcoding a schema, we read 1-3 existing DESIGN.md files
# from the OD repo at runtime to learn which top-level sections are conventional,
# then check the new file has at least those sections (case-insensitive H1/H2 match).
#
# Heuristic-only: warns rather than fails on missing optional sections; only fails
# when the file is empty, unparseable, or has zero structural overlap with samples.
set -uo pipefail
source "$(dirname "$0")/config.sh"
NEW_FILE="${1:?DESIGN.md path required}"
shift || true
REFERENCE_FILES=()
while (($#)); do
case "$1" in
--reference) REFERENCE_FILES+=("$2"); shift 2 ;;
*) od::die "unknown flag: $1" ;;
esac
done
[[ -f "$NEW_FILE" ]] || od::die "not a file: $NEW_FILE"
[[ -s "$NEW_FILE" ]] || od::die "file is empty: $NEW_FILE"
extract_headings() {
# Pull H1/H2 lines, lowercase, trim, dedupe.
awk '/^#{1,2}[[:space:]]+/ { sub(/^#{1,2}[[:space:]]+/, ""); print tolower($0) }' "$1" \
| sed -E 's/[[:space:]]+$//' | sort -u
}
new_headings="$(extract_headings "$NEW_FILE")"
[[ -n "$new_headings" ]] || { printf 'FAIL no H1/H2 headings found in %s — is this really a design system doc?\n' "$NEW_FILE"; printf 'RESULT=fail\n'; exit 1; }
# If references were supplied, build the union of their headings as the "expected" set.
EXPECTED=""
for ref in "${REFERENCE_FILES[@]}"; do
[[ -f "$ref" ]] || continue
EXPECTED+=$'\n'"$(extract_headings "$ref")"
done
EXPECTED="$(printf '%s' "$EXPECTED" | grep -v '^$' | sort -u || true)"
PASS=0
WARN=0
FAIL=0
if [[ -z "$EXPECTED" ]]; then
printf 'WARN no reference DESIGN.md provided — running structure-only checks\n'
WARN=$((WARN+1))
else
# Count overlap. >= 30% structural overlap = looks like a design system.
overlap=0
total=0
while IFS= read -r h; do
[[ -z "$h" ]] && continue
total=$((total+1))
if printf '%s\n' "$new_headings" | grep -Fxq "$h"; then
overlap=$((overlap+1))
fi
done <<< "$EXPECTED"
if [[ "$total" -eq 0 ]]; then
printf 'WARN references parsed but had no headings\n'; WARN=$((WARN+1))
else
pct=$(( overlap * 100 / total ))
if [[ "$pct" -ge 30 ]]; then
printf 'PASS structural overlap with reference DESIGN.md files: %d%% (%d/%d)\n' "$pct" "$overlap" "$total"
PASS=$((PASS+1))
else
printf 'FAIL structural overlap with reference DESIGN.md files only %d%% (%d/%d) — likely missing required sections\n' "$pct" "$overlap" "$total"
FAIL=$((FAIL+1))
fi
fi
fi
# Always-on lightweight checks:
if grep -qE '^(#)[[:space:]]+' "$NEW_FILE"; then
printf 'PASS has at least one H1 heading\n'; PASS=$((PASS+1))
else
printf 'WARN no H1 heading found — convention is one H1 with the brand/system name\n'; WARN=$((WARN+1))
fi
# No relative path escape (../).
if grep -nE '\(\.\./' "$NEW_FILE" >/dev/null; then
printf 'WARN contains ../ relative paths — make sure they resolve once placed at design-systems/<brand>/DESIGN.md\n'; WARN=$((WARN+1))
fi
if [[ "$FAIL" -eq 0 ]]; then
printf 'RESULT=pass (passes=%d warns=%d)\n' "$PASS" "$WARN"
exit 0
else
printf 'RESULT=fail (passes=%d warns=%d fails=%d)\n' "$PASS" "$WARN" "$FAIL"
exit 1
fi
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 |