Skills — Conjunto de Competências Claude para Automação
Chaeguevara/Skills
Skills TypeScript para persistência de conhecimento e automação multiplataforma
Ver no GitHubColeção de skills em TypeScript que estende Claude com conhecimento persistente em origami computacional, integração Obsidian, otimizações Next.js e boas práticas documentação. Cada skill é auto-contido e acionado por padrões de linguagem natural, capturando footguns reais e conhecimento de domínio para reutilização entre sessões.
Instalação
npx convez-ai Chaeguevara/Skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Criar e manter vault de conhecimento no Obsidian com wiki-links automáticas
- Resolver footguns frequentes em Next.js (AdSense, search params, fontes coreanas, OG images)
- Aplicar teoremas de origami computacional (Maekawa, Kawasaki) em problemas de dobra
- Fragmentar documentação longa em shards interligadas para melhor compreensão de LLM
Veredito

Repositório bem estruturado de skills produção-ready que endereça dores reais em Next.js e captura conhecimento técnico especializado. Excelente para quem quer estender Claude com contexto persistente e automações workflow, mas requer familiaridade com TypeScript e arquitetura de skills.
README
A tradução para o português deste README ainda está na fila.
Skills
Claude Code skills for persistent knowledge and automation across every session.
Reference / domain knowledge
geometric-folding
Reference knowledge base for mathematical and computational origami. Loaded automatically when any session touches folding theory.
Covers: Maekawa's theorem (|M−V|=2), Kawasaki's theorem (alternating angles), local foldability conditions, local foldability graphs (LFG), degree-4 vertices, layer ordering, global flat-foldability (NP-hardness), tree method, box pleating, and rigid origami.
Files: SKILL.md, theorems-deep.md
obsidian-knowledge
Captures knowledge into the Obsidian PARA vault as a properly formatted markdown note with wiki-links to related existing notes.
Triggers on: "save this", "add this to my vault", "create a note for this", "take notes on", or pasted content to preserve.
Files: SKILL.md, frontmatter-patterns.md, vault-index.md
obsidian-daily
Creates today's daily note in the Obsidian PARA vault (00.Inbox/YYYY-MM-DD.md). Reports the path if the note already exists; otherwise creates it from a lean template.
Files: SKILL.md
docs-toc-shards-style
Split a long project root doc (SPEC.md / README.md / PLAN.md / ARCHITECTURE.md) into a thin TOC + many small interlinked shards under docs/. Each shard 2–5KB, one topic, with [[wiki-link]] cross-references. Triggers on "SPEC 너무 길다", "잘게 쪼개라", "TOC 만들자", "LLM이 빠르게 찾아갈 수 있게", or whenever a root doc grows past ~200 lines / 15KB. Designed around the attention-mechanism reality that long docs lose the middle.
Files: SKILL.md
Web / Next.js gotchas (general)
These capture footguns I've stepped on more than once. Each is a self-contained SKILL.md with reproducer + fix.
nextjs-adsense-script
Add Google AdSense to a Next.js App Router site without breaking the data-nscript validator. Use raw <script> JSX or lazy DOM injection — never next/script directly.
nextjs-search-params-ssg
Read ?foo=bar query params in a fully static page without breaking SSG. useSearchParams() requires a Suspense boundary; use window.location.search in useEffect for cosmetic flags.
nextjs-cls-korean-fonts
Fix Cumulative Layout Shift caused by Korean web fonts loaded via next/font/google. display: "optional" + preload: false eliminates the swap-driven reflow.
ssg-determinism
Pre-compute clusters / samples / rankings at build time without breaking deterministic builds. Replace Math.random with seeded RNG or max-min-distance init.
rsc-client-prop-shape
Decide what shape of data to send from a Next.js Server Component to a Client Component. Project to compact form before passing — large props inflate the page HTML and hurt LCP.
nextjs-og-image-metadata
Avoid the generateImageMetadata footgun in dynamic OG image routes. If misused, every page in [id]/opengraph-image.tsx gets <meta og:image> tags for ALL siblings — RSC payload bloats 5–10×. Includes a scanner.
nextjs-browserslist-turbopack
Force modern-target browser compilation in Next 16 + Turbopack. package.json browserslist is silently ignored; use .browserslistrc to drop ~14KB of legacy method polyfills. Includes a polyfill scanner.
nextjs-preconnect-strategy
Decide where to put <link rel="preconnect"> in App Router — root layout vs per-page. Avoids "Unused preconnect" / ">4 preconnects" Lighthouse warnings. Covers the silent-killer crossorigin mismatch (preconnect's crossOrigin must match the actual fetch's mode) + preconnect vs dns-prefetch trade-off.
nextjs-conditional-feature-bundling
Chunk-split conditional features (?beta=1, modals, admin panels) so they only download when triggered. Components via next/dynamic, libraries via import() inside useEffect. Includes a scanner for static-import + conditional-render candidates.
bulk-data-via-script-not-tokens
대량 데이터(공공 API, 엑셀, CSV, 페이지네이션 응답)를 토큰으로 처리하지 않고 데이터 구조를 이해한 뒤 스크립트로 옮기는 패턴. probe → script → metrics-only report. 한글 정규화, 페이지네이션, 매칭 폴백 체인 포함.
Apple platforms — SwiftUI / iOS / macOS / watchOS gotchas
Cadence (timer) 프로젝트에서 부딪힌 실제 시행착오들. 각각 increased self-containment + 구체적 reproducer + fix.
macOS SwiftUI 윈도우 빌드/구동 이슈
macos-app-launch-diagnosis— "앱이 안 뜬다" / "메모리 문제 같다" 같이 모호한 증상을 좁히는 명령어 워크플로우 (ps,sample,CGWindowList,screencapture -D). 다른 5개 macOS 스킬의 입구.swiftui-menubarextra-no-timelineview—MenuBarExtra라벨 안에TimelineView(.periodic(by: 1))쓰면 macOS 26 SwiftUI 가MenuBarExtraController.updateButton무한 루프 → 100% CPU + 메인 윈도우 0×0.swiftui-window-vs-windowgroup-menubarextra—Window+MenuBarExtra조합은 state restoration 때문에 윈도우가 안 열림.WindowGroup으로 바꾸기.swiftui-window-offscreen-restore-fix— 외부 모니터에 떠있던 saved frame 이 모니터 분리/꺼짐 후에도 복원돼서 윈도우가 안 보임.NSViewRepresentable+Timer폴링으로NSScreen.main위로 재배치.swiftui-window-defaultsize— 컨텐트의.frame(idealWidth:idealHeight:)는 윈도우 사이즈 결정에 무력. Scene-level.defaultSize(width:height:)필수.
Swift 6 / AppIntents / Widget extension
swift6-appintent-static-let— Swift 6 strict concurrency 에서AppIntent.title/description/openAppWhenRun같은static var는 컴파일 에러. 전부static let으로.swift6-sending-non-sendable-apple-types— Apple framework 의 non-Sendable 타입 (Activity<T>,[String: Any],WCSession등) 을 actor boundary 너머로 보낼 때 "sending 'X' risks data races" 에러.@retroactive @unchecked Sendableextension 또는@unchecked Sendable Box패턴.xcodegen-share-files-widget-extension— Widget extension 이 메인 앱의App/Shared/타입을 못 본다. xcodegenProject.yml에서 extension 타겟 sources 에 개별 파일 명시.swiftui-list-selection-ios-optional— iOS / iPad 의List(_:selection:)single-select 는Binding<Element?>만 받음. macOS 에서 복붙한Binding<Element>는 "init unavailable in iOS" 에러.swiftui-cross-platform-conditional-modifiers—textInputAutocapitalization(iOS-only),textFieldStyle(.roundedBorder)(not watchOS),popover(not watchOS),keyboardShortcut(non-Optional KeyEquivalent) 등 modifier 가 platform 마다 unavailable 일 때 한 줄만#if os(...)로 conditional. 더 복잡한 케이스는 ViewModifier 추출.swiftui-version-counter-store-bridge—@Observable아닌 protocol-backed store 의 mutation 을 SwiftUI view 가 react 못 할 때,@ObservableAppModel 에 version counter 두고 mutation wrapper 에서 bump + view body 첫 줄에 read 로 dependency 등록.
macOS 시스템 통합
macos-nspanel-screensaver-overlay— 모든 앱 위에 모든 Space 에서 보이는 일시적 alert/overlay.NSPanel+.level = .screenSaver+.collectionBehavior = [.canJoinAllSpaces, .stationary, .fullScreenAuxiliary]. UNUserNotification 으로 부족한 "지금 봐야 한다" 케이스. multi-monitor 환경에서 content 가 모니터 사이 갭에 떠 있는 함정 +NSScreen.main기준.position(x:y:)anchor 패턴 포함.
SwiftUI 데이터 / 파일 처리
swiftdata-add-field-migration— 출시된 SwiftData 앱의@Model에 새 필드 추가 시 lightweight migration 이 조용히 실패해서 사용자 데이터가 비거나 in-memory fallback 됨. 3-layer 폴백 패턴 — 신규 필드 Optional +asValue의?? .default+ CodabledecodeIfPresent. 시뮬레이터는 fresh store 라 못 잡고 실기기 OTA 케이스에서만 터짐.swiftui-fileexporter-native-save— macOS 네이티브NSSavePanel/ iOS Files 피커를.fileExporter+ 얇은FileDocument(data: Data)래퍼로 띄우는 패턴. 단 사용자가 share sheet 같은 다양한 destination 원하면 macOS = NSSavePanel + iOS = ShareLink#if분기 필요 (안에 설명).swiftui-form-binding-closure-typecheck-timeout—Form안에.fileExporter여러 개 +Binding(get:set:)closure 패턴 chain 하면 Swift type-checker 가 timeout 으로 bail out → "Cannot find type 'X'" 가 file 전체에 도미노로 뜸 (import 멀쩡한데도). Fix — closure-Binding 버리고@State Boolflag 로.macos-sandbox-savepanel-entitlement— macOS sandboxed 앱에서 NSSavePanel /.fileExporter가 silent fail. console 에 "needs User Selected File Read/Write" 메시지..entitlements의 read-only → read-write 한 줄 변경.
SwiftUI 시각 디자인 / hit-test
swiftui-tinted-surface-chip-legibility— phase/category 뱃지를phase.tintforeground +phase.tint.opacity(0.12)background 로 그리면 tint-on-tint 라 글자가 거의 안 보임 (특히 teal/cyan/yellow)..secondarytext 도 light tinted surface 위에서 wash-out. 3가지 fix 패턴 — solid tint capsule + white text /.primary+.semibold/.regularMaterialbackground.swiftui-stroke-only-shape-hittest—RoundedRectangle().strokeBorder(...)만 적용된 shape 은 hit-test 영역이 stroke 픽셀만 — 점선 사이 빈 공간 / 카드 가운데가 안 눌림. "+Add" 카드 / placeholder cell 패턴에서 자주 발생. Fix —.contentShape(.rect(cornerRadius: N))+Color(white: 0.5, opacity: 0.001)의 invisible fill.sfsymbols-numeric-circle-range-50— SF Symbols 의N.circle.fill시리즈는 0~50 만 존재.100.circle.fill같은 건 placeholder 로 fallback + IconRendering framework 노이즈 줄줄. milestone 은trophy.fill/crown.fill/medal.fill같은 의미 기반 symbol 로.
Xcode 빌드 도구
xcodebuild-developer-dir-override—xcode-select가 CommandLineTools 면xcodebuild가 거부.sudo대신DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer xcodebuild ...로 명령 단위 우회.
Structure
Each skill is a directory containing SKILL.md (frontmatter + body). Some skills also bundle reference scripts/templates that the body links to:
skills/
├── data-go-kr-api-quirks/
│ ├── SKILL.md
│ ├── probe-endpoint.sh # bash probe for /info /list /v1 path discovery
│ └── ingest-skeleton.mts # reusable TS ingest with pagination + matching
├── tier-grading-system/
│ ├── SKILL.md
│ └── calibrate-thresholds.mjs # feed scores → recommend S/A/B/C/D thresholds
├── click-anchor-similarity/
│ ├── SKILL.md
│ └── example-implementation.ts # cosine similarity + autoWeights + rank
├── nextjs-static-route-bundle/
│ ├── SKILL.md
│ └── route-template.ts # copy-paste route handler + client fetch
└── ... # other skills (markdown only when self-contained)
When a skill has a "Bundled tool" callout near the top of its SKILL.md, that means it ships with reusable scripts. Single-md skills are self-contained patterns where the inline code snippet is enough.