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/discover-doc-gaps.sh

View on GitHub
#!/usr/bin/env bash
# Find low-effort doc improvements in nexu-io/open-design.
# Usage: discover-doc-gaps.sh <workdir>
# Stdout: NDJSON rows. Three classes:
#   {"kind":"todo","file":"docs/foo.md","line":42,"text":"TODO: explain the daemon"}
#   {"kind":"typo","file":"README.md","line":17,"word":"recieve","suggested":"receive"}
#   {"kind":"deadlink","file":"docs/bar.md","line":3,"url":"https://example.com/x","status":"404"}
#
# Dead-link checks are best-effort: timeout 8s, only reports 4xx/5xx/timeout, not network errors.

set -uo pipefail
source "$(dirname "$0")/config.sh"

WORKDIR="${1:?workdir required}"
[[ -d "$WORKDIR/.git" ]] || od::die "not a git workdir: $WORKDIR"

cd "$WORKDIR"
od::require jq

# Use ripgrep when present for speed; fall back to grep -rE.
if command -v rg >/dev/null 2>&1; then
  GREP() { rg --no-heading --line-number --color never "$@"; }
else
  GREP() {
    # Translate a couple of rg flags we use to grep-equivalents.
    local args=()
    while (($#)); do
      case "$1" in
        --no-heading|--color) shift ;;
        --color=never) shift ;;
        --line-number) args+=("-n"); shift ;;
        *) args+=("$1"); shift ;;
      esac
    done
    grep -rE "${args[@]}"
  }
fi

# 1) TODOs / FIXMEs in docs.
emit_todo() {
  while IFS=: read -r file line rest; do
    [[ -z "$file" ]] && continue
    jq -nc --arg file "$file" --argjson line "$line" --arg text "$rest" \
      '{kind:"todo", file:$file, line:$line, text:($text|sub("^[[:space:]]+";""))}'
  done
}

GREP --no-heading --line-number --color never -e 'TODO|FIXME|XXX' \
  -g '*.md' docs/ README*.md QUICKSTART*.md CONTRIBUTING*.md 2>/dev/null \
  | emit_todo || true

# Fallback path for environments where rg --glob isn't available — grep equivalent.
if ! command -v rg >/dev/null 2>&1; then
  grep -rEn -- 'TODO|FIXME|XXX' docs README*.md QUICKSTART*.md CONTRIBUTING*.md 2>/dev/null \
    | emit_todo || true
fi

# 2) Common typos. Whole-word match, case-sensitive (avoid false positives in code/links).
TYPOS=(
  "teh|the"
  "recieve|receive"
  "seperate|separate"
  "occured|occurred"
  "succesful|successful"
  "untill|until"
  "wich|which"
  "thier|their"
  "alot|a lot"
  "definately|definitely"
  "neccessary|necessary"
  "enviroment|environment"
  "transparant|transparent"
  "appearence|appearance"
)

for entry in "${TYPOS[@]}"; do
  bad="${entry%%|*}"
  good="${entry##*|}"
  while IFS=: read -r file line _rest; do
    [[ -z "$file" ]] && continue
    # Skip code blocks (rough heuristic: skip if line is inside ```).
    jq -nc --arg file "$file" --argjson line "$line" --arg word "$bad" --arg good "$good" \
      '{kind:"typo", file:$file, line:$line, word:$word, suggested:$good}'
  done < <(GREP --no-heading --line-number --color never -e "\\b${bad}\\b" -g '*.md' . 2>/dev/null \
           || grep -rEn "\\b${bad}\\b" --include='*.md' . 2>/dev/null \
           || true)
done

# 3) External link health (best-effort, capped).
# Cap to 50 links per run so we don't hammer arbitrary hosts.
MAX_LINKS=50
SEEN=0
extract_links() {
  GREP --no-heading --line-number --color never -e '\]\(https?://[^) ]+\)' -g '*.md' . 2>/dev/null \
    || grep -rEn '\]\(https?://[^) ]+\)' --include='*.md' . 2>/dev/null
}

while IFS= read -r row; do
  [[ "$SEEN" -ge "$MAX_LINKS" ]] && break
  file="${row%%:*}"
  rest="${row#*:}"
  line="${rest%%:*}"
  text="${rest#*:}"
  # Extract first http(s) URL on the line.
  url="$(printf '%s' "$text" | grep -oE 'https?://[^) ]+' | head -1)"
  [[ -z "$url" ]] && continue
  SEEN=$((SEEN+1))
  # HEAD with 8s timeout, follow redirects, take final status.
  status="$(curl -sS -o /dev/null -m 8 -L -w '%{http_code}' --head "$url" 2>/dev/null || echo "000")"
  case "$status" in
    2*|3*) ;;  # OK
    000) ;;    # network/timeout — skip rather than spam false positives
    *)
      jq -nc --arg file "$file" --argjson line "$line" --arg url "$url" --arg status "$status" \
        '{kind:"deadlink", file:$file, line:$line, url:$url, status:$status}'
      ;;
  esac
done < <(extract_links | head -n "$MAX_LINKS")
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