convez.ai
SkillAutomaçãoAvançado
Chaeguevara

Skills — Conjunto de Competências Claude para Automação

Chaeguevara/Skills

Skills TypeScript para persistência de conhecimento e automação multiplataforma

Ver no GitHub
InicialPluginScore · de 0 a 100

Coleçã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/Skills

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
1
Contribuidores
1

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 Sendable extension 또는 @unchecked Sendable Box 패턴.
  • xcodegen-share-files-widget-extension — Widget extension 이 메인 앱의 App/Shared/ 타입을 못 본다. xcodegen Project.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 못 할 때, @Observable AppModel 에 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 + Codable decodeIfPresent. 시뮬레이터는 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 Bool flag 로.
  • 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.tint foreground + phase.tint.opacity(0.12) background 로 그리면 tint-on-tint 라 글자가 거의 안 보임 (특히 teal/cyan/yellow). .secondary text 도 light tinted surface 위에서 wash-out. 3가지 fix 패턴 — solid tint capsule + white text / .primary + .semibold / .regularMaterial background.
  • 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.

Ver o original no GitHub

Bom para

Relacionados