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/create-issue.sh
View on GitHub#!/usr/bin/env bash
# Create a bug-report issue on nexu-io/open-design from a rendered body file.
# Usage:
# create-issue.sh --title "<issue title>" --body-file <rendered .md>
# [--allow-duplicates] [--dedupe-keywords "<kw>"]
#
# Dedupe gate (now actually a gate, not a print):
# - If --dedupe-keywords is supplied, the script runs `gh search issues`
# FIRST and writes the matches to stderr.
# - If any matches are found AND --allow-duplicates was NOT passed, the
# script EXITS NON-ZERO with a clear hint and refuses to call
# `gh issue create`. This lets the agent (per SKILL.md Step 3d.4) show
# the matches to the user and only re-invoke with --allow-duplicates
# after the user explicitly chose "open a new issue anyway".
# - If `gh search` ITSELF fails (network, rate limit, jq parse error),
# the script also exits non-zero. Failing closed is the right default
# for a bug-dedupe gate — we'd rather block creation than open
# potentially redundant issues silently.
#
# Caller contract (matches SKILL.md):
# 1. Run with --dedupe-keywords on first attempt; show output to user.
# 2. If exit is non-zero with REASON=duplicates_found, ask the user.
# 3. If user picks "open anyway", re-run WITHOUT --dedupe-keywords (or
# WITH --allow-duplicates). The script then creates the issue.
#
# Emits the issue URL on its own line (stdout) on success.
set -euo pipefail
source "$(dirname "$0")/config.sh"
TITLE=""
BODY_FILE=""
DEDUPE_KEYWORDS=""
ALLOW_DUPES=0
while (($#)); do
case "$1" in
--title) TITLE="$2"; shift 2 ;;
--body-file) BODY_FILE="$2"; shift 2 ;;
--dedupe-keywords) DEDUPE_KEYWORDS="$2"; shift 2 ;;
--allow-duplicates) ALLOW_DUPES=1; shift ;;
*) od::die "unknown flag: $1" ;;
esac
done
[[ -n "$TITLE" ]] || od::die "--title required"
[[ -f "$BODY_FILE" ]] || od::die "--body-file does not exist: $BODY_FILE"
od::require gh
od::require jq
if [[ -n "$DEDUPE_KEYWORDS" && "$ALLOW_DUPES" -eq 0 ]]; then
od::log "checking for duplicates: $DEDUPE_KEYWORDS"
# Run gh search and jq as separate steps so a failure in either is loud
# rather than swallowed by `|| true`. The previous implementation chained
# them with `|| true`, which let a network or jq error mask "no duplicates"
# vs "search broken" — both produced empty output and the script then
# created the issue regardless.
if ! SEARCH_JSON="$(gh search issues "$DEDUPE_KEYWORDS" \
--repo "$TARGET_REPO" \
--state open \
--limit 5 \
--json number,title,url 2>&1)"; then
od::err "gh search failed: $SEARCH_JSON"
printf 'REASON=search_failed\n' >&2
exit 2
fi
MATCH_COUNT="$(printf '%s' "$SEARCH_JSON" | jq -r 'length' 2>/dev/null || echo 'parse-error')"
if [[ "$MATCH_COUNT" == "parse-error" ]]; then
od::err "could not parse gh search output as JSON"
printf 'REASON=parse_failed\n' >&2
exit 2
fi
if (( MATCH_COUNT > 0 )); then
printf '%s' "$SEARCH_JSON" \
| jq -r '.[] | " #\(.number) \(.title)\n \(.url)"' >&2
od::err "${MATCH_COUNT} potentially duplicate open issue(s) found."
od::err "Refusing to create a new issue. Show these to the user and ask:"
od::err " (a) comment on an existing one — open the URL above"
od::err " (b) open a new issue anyway — re-run with --allow-duplicates"
od::err " (c) cancel — do nothing"
printf 'REASON=duplicates_found\n' >&2
printf 'MATCH_COUNT=%s\n' "$MATCH_COUNT" >&2
exit 3
fi
od::log "no duplicates found — proceeding with create"
fi
URL="$(gh issue create \
--repo "$TARGET_REPO" \
--title "$TITLE" \
--body-file "$BODY_FILE" \
--label bug)" || od::die "gh issue create failed"
printf '\n'
printf '%s\n' "$URL"
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 |