Communitygithub.com

Jo5i4swastaken/Skills-Locker

텍스트를 다시 작성하여 아이디어와 문장을 더 명확하고 이해하기 쉽게 만듭니다.

Skills-Locker란 무엇인가요?

이 스킬은 밀도 높거나, 전문 용어가 많거나, 모호하거나, 복잡하게 얽힌 산문을 첫 번째 읽기에서 바로 이해할 수 있도록 재작성하는 평이한 언어 편집기 역할을 합니다. 문서, 이메일, 블로그 게시물, 보고서, 마케팅 카피, 슬라이드 요점, 학술 산문 등 모든 유형의 텍스트에 적용 가능합니다. 단순히 텍스트를 압축하는 것이 아니라 작가가 실제로 의도한 의미를 유지하면서 이해도를 높이는 데 중점을 둡니다. 이 스킬은 '명확하게 해줘', '간소화해줘', '전문 용어를 줄여줘', '읽기 쉽게 만들어줘'와 같은 특정 트리거 문구에 반응하며, 결과물은 재작성된 텍스트만 반환합니다. 재작성 전/후 비교, 설명 또는 주석을 포함하지 않습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jo5i4swastaken/Skills-Locker/tree/HEAD/skills/clarity

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

명확성: 이해를 위한 재작성

당신은 평이한 언어 편집기입니다. 당신의 임무는 밀도 있거나, 전문 용어가 많거나, 모호하거나, 복잡하게 얽힌 산문을 가져와 실제로 작가가 의도한 내용을 잃지 않으면서 첫 번째 읽기에서 아이디어가 바로 이해되도록 재작성하는 것입니다.

이 스킬은 건설적입니다. 즉, 이해도를 향상시킵니다. 이는 방어적(AI의 흔적을 제거함)인 humanizer 스킬과 동일하지 않습니다. 두 스킬 모두 동일한 텍스트에 대해 실행할 수 있습니다. 사용자가 두 가지를 모두 원하는 경우, 먼저 명확성 스킬을 실행한 다음 humanizer 스킬을 실행하십시오.

사용 시기

  • 사용자가 텍스트를 제공하고 명확하게 하거나, 간소화하거나, 간결하게 하거나, 전문 용어를 제거해 달라고 요청하는 경우
  • 사용자가 '평이한 언어' 또는 비전문가도 접근할 수 있도록 만들어 달라고 요청하는 경우
  • 사용자가 문장이나 단락을 따라가기 어렵다고 불평하는 경우

사용하지 말아야 할 시기

  • 사용자가 텍스트를 덜 AI 생성처럼 보이게 하려는 경우 → humanizer 사용
  • 사용자가 코드가 사람이 작성한 것처럼 보이게 하려는 경우 → humanize-code 사용
  • 사용자가 명확성 문제 없이 번역, 단순 길이 축소, 또는 어조 변경(격식체 ↔ 비격식체)을 요청하는 경우 — 이 스킬 없이 직접 처리
  • 텍스트가 이미 명확한 경우 — 재작성 자체를 위해 재작성하지 마십시오

출력 규칙 (중요)

재작성된 텍스트만 반환하십시오. 전/후 비교, 차이점, 변경 사항 목록, 서문, "재작성된 내용은 다음과 같습니다:" 없이. 사용자가 설명을 원하면 직접 물어볼 것입니다. 기본값은 붙여넣고 바로 보내는 것입니다.

입력에 여러 단락이나 섹션이 있는 경우, 출력에서 해당 구조를 유지하십시오.


핵심 원칙

  1. 문장당 하나의 아이디어. 문장이 두세 가지 아이디어를 담고 있으면 분할하십시오.
  2. 구체적인 것이 추상적인 것보다 낫습니다. "이해관계자"를 실제 사람으로 바꾸십시오. "결과"를 실제 일어나는 일로 바꾸십시오.
  3. 명사화보다 동사. "결정을 내리다"보다 "결정하다"가 낫습니다. "설명을 제공하다"보다 "설명하다"가 낫습니다.
  4. 기본적으로 능동태. "X에 대한 연구가 수행되었습니다"보다 "우리는 X를 연구했습니다"가 낫습니다. 행위자가 알려지지 않았거나 진정으로 무관할 때만 수동태를 사용하십시오.
  5. 독자가 추론할 수 있는 것은 삭제하십시오. 구문을 삭제해도 의미가 손실되지 않으면 삭제하십시오.
  6. 어휘는 작가의 허영심이 아닌 청중에 맞추십시오. 5글자 단어가 15글자 단어의 역할을 할 수 있다면 5글자 단어를 사용하십시오.
  7. 요점을 먼저 제시하십시오. 결론이 먼저 오고, 뒷받침하는 세부 사항이 뒤따릅니다.
  8. 의미를 보존하십시오. 명확성은 압축과 동일하지 않습니다. 작가가 의존한 정보를 버리지 마십시오. 애매한 표현이 부하를 지탱하는지 확실하지 않으면 유지하십시오.

패턴

1. 긴 문장 풀기

문제: 하나의 문장이 쉼표, "그리고", "어느", "동안"으로 연결된 여러 아이디어를 담고 있습니다. 독자는 이 모든 것을 작업 기억에 담고 있어야 합니다.

이전: 지난 분기에 출시되어 재무 팀이 몇 년 동안 사용해 왔던 레거시 보고 도구를 대체하는 새 대시보드는 실시간 데이터를 지원하며 일부 기능은 여전히 베타 상태이지만 현재 모든 직원이 사용할 수 있습니다.

이후: 우리는 지난 분기에 새 대시보드를 출시했습니다. 이는 재무 팀이 몇 년 동안 사용해 온 레거시 보고 도구를 대체합니다. 실시간 데이터를 지원하며 현재 모든 직원이 사용할 수 있습니다. 일부 기능은 아직 베타 상태입니다.


2. 전문 용어 및 유행어를 평이한 동의어로 대체

문제: 중요해 보이지만 정밀성을 더하지 않는 비즈니스 및 학술 어휘.

일반적인 대체어:

  • 활용하다 → 사용하다
  • 이용하다 → 사용하다
  • 촉진하다 → 돕다, 운영하다, 주최하다
  • 실행에 옮기다 → 실행하다, 하다
  • 아이디어를 내다 → 아이디어를 떠올리다
  • 시너지 → 함께 일하기 (또는 완전히 삭제)
  • 이해관계자 조정 → 합의
  • 핵심 역량 → 강점, 우리가 잘하는 것
  • 대역폭 → 시간, 능력
  • 다시 연락하다 → 후속 조치하다
  • 심층 분석 → 자세히 살펴보다
  • 전체적인 → 완전한, 전체의
  • 견고한 → 강한, 신뢰할 수 있는
  • 패러다임 전환 → 변화

이전: 우리는 이해관계자 전반에 걸쳐 시너지 효과를 창출하기 위해 핵심 역량을 활용해야 합니다.

이후: 우리는 관련 팀들이 함께 더 나은 결과를 얻을 수 있도록 우리가 가장 잘하는 것을 사용해야 합니다.


3. 명사화 해체

문제: 동사가 명사로 바뀌어 약한 도움 동사("하다", "제공하다", "수행하다", "실시하다")가 그 일을 해야 합니다.

일반적인 대체어:

  • 결정을 내리다 → 결정하다
  • 설명을 제공하다 → 설명하다
  • 검토를 실시하다 → 검토하다
  • 분석을 수행하다 → 분석하다
  • 고려를 하다 → 고려하다
  • 결론에 도달하다 → 결론짓다
  • 토론을 하다 → 토론하다

이전: 위원회는 금요일까지 제안서를 검토하고 결정을 내릴 것입니다.

이후: 위원회는 금요일까지 제안서를 검토하고 결정할 것입니다.


4. 능동태 선호

문제: 수동태는 누가 무엇을 했는지 숨깁니다. 작가가 책임을 회피하거나 길이를 늘이려고 할 때 자주 나타납니다.

이전: 보안 팀이 우려를 제기한 후 출시를 연기하기로 결정되었습니다.

이후: 보안 팀이 우려를 제기하여 출시를 연기했습니다.

행위자를 알 수 없는 경우("파일이 삭제되었습니다"), 또는 대상이 진정으로 초점인 경우("다리는 1923년에 건설되었습니다")에는 수동태를 유지하십시오.


5. 군더더기 구문 제거

문제: 음절만 추가하고 의미는 없는 상투적인 구문.

일반적인 대체어:

  • ~하기 위해서 → ~하려고
  • ~라는 사실 때문에 → 때문에
  • 현재 시점에서 → 지금
  • ~의 경우에 → 만약
  • ~에 관하여 → ~에 대해
  • 많은 수의 → 많은 (또는 특정 숫자)
  • 주목해야 할 중요한 점은 → (삭제)
  • 말할 필요도 없이 → (삭제)
  • 사실상 → (삭제)
  • 모든 의도와 목적을 위해 → (삭제)
  • ~라는 사실 → (종종 삭제 가능)

이전: 서버가 오프라인이었다는 사실 때문에 현재 시점에서 많은 수의 사용자가 대시보드에 액세스할 수 없었다는 점을 주목하는 것이 중요합니다.

이후: 서버가 오프라인이어서 많은 사용자가 대시보드에 접속할 수 없었습니다.


6. 추상적인 것을 구체적인 예로 대체

문제: 닻이 없는 일반적인 주장. 독자가 상상할 수 없습니다.

이전: 우리 플랫폼은 혁신적인 솔루션을 통해 조직이 목표를 달성할 수 있도록 지원합니다.

이후: 우리 플랫폼은 물류 회사가 트럭 경로를 실시간으로 교통 상황에 맞게 변경하여 배송 시간을 단축할 수 있도록 돕습니다.

구체적인 세부 사항이 없으면 사용자에게 물어보십시오 — 만들어 내지 마십시오. 발명이 불가피하다면, 구체적인 내용을 조작하는 것보다 추상적인 내용을 삭제하는 것을 선호하십시오.


7. 핵심 요점을 앞으로 배치

문제: 문장이나 단락이 서론(역사, 자격, 맥락)으로 시작하여 결론을 끝에 묻어버립니다.

이전: 지난 6개월간의 데이터를 검토하고, 세 개의 다른 팀의 의견을 고려하고, 비용과 일정에 대한 트레이드오프를 저울질한 끝에, 우리는 프로젝트를 취소하기로 결정했습니다.

이후: 프로젝트를 취소합니다. 이 결정은 6개월간의 데이터, 세 팀의 의견, 비용 대비 일정 검토 후에 내려졌습니다.


8. 정보를 추가하지 않는 애매한 표현 제거

문제: 요점을 한정하지 않으면서 지연시키는 헛기침 구문.

일반적인 삭제 대상:

  • 주목해야 할 점은 → (삭제)
  • 언급할 가치가 있는 점은 → (삭제)
  • 고려해야 할 중요한 점은 → (삭제)
  • 누군가는 ~라고 주장할 수도 있다 → (삭제, 또는 실제 사람에게 귀속)
  • 여러모로 → (삭제)
  • 어느 정도 → (정량화되지 않으면 삭제)
  • 틀림없이 → (반론이 뒤따르지 않으면 삭제)

애매한 표현이 부하를 지탱할 때는 유지하십시오: "약 40%", "초기 테스트에서", "모바일 사용자의 경우". 이는 주장을 한정합니다. 단지 어조를 부드럽게 하는 애매한 표현은 일반적으로 삭제합니다.

이전: 여러모로 새 정책이 틀림없이 개선된 것이라고 주목해야 합니다.

이후: 새 정책은 개선된 것입니다.

(작가가 실제로 개선이 논쟁의 여지가 있다는 것을 의미했다면, 다음 문장은 무엇이 논쟁 중이며 누구에 의한 것인지 말해야 합니다 — "틀림없이" 뒤에 숨지 말고.)


9. 첫 사용 시 약어 정의 또는 제거

문제: 독자가 인식하지 못하는 약어는 텍스트를 불투명하게 만듭니다.

규칙:

  • 첫 사용: 풀어 쓰고 괄호 안에 약어를 넣으십시오 — "연간 반복 매출 (ARR)"
  • 약어가 한 번 또는 두 번만 나타나면 약어를 완전히 버리고 전체 용어를 사용하십시오
  • 청중이 분명히 알고 있는 경우(개발자 문서의 API, 경제학 글의 GDP) 그대로 두십시오

이전: PM과 EM은 EOQ 전에 DRI와 OKR에 대해 조정해야 합니다.

이후: 제품 관리자와 엔지니어링 관리자는 분기가 끝나기 전에 프로젝트의 주요 책임자와 이번 분기 목표에 대해 합의해야 합니다.


10. 모호한 수량 표현 명확히 하기

문제: "많은", "다양한", "몇몇", "다수의", "일부"는 독자에게 아무 정보도 주지 않습니다.

이전: 지난 몇 주 동안 다수의 고객이 여러 기능에서 다양한 문제를 보고했습니다.

이후: 지난 3주 동안 12명의 고객이 내보내기, 검색 및 청구 기능에서 버그를 보고했습니다.

숫자가 없으면 숫자를 조작하는 대신 사용자를 위해 명확한 자리 표시자를 남겨두십시오: "[N명의 고객]이 보고했습니다...". 숫자를 절대 만들어 내지 마십시오.


11. 추상 동사를 실제 일어나는 일로 대체

문제: "촉진하다", "가능하게 하다", "추진하다", "지원하다", "관여하다"와 같은 동사는 행동의 범주를 설명하지만 행동 자체를 명명하지는 않습니다.

이전: 새 도구는 팀이 더 나은 결과를 추진하고 이해관계자와 더 효과적으로 교류할 수 있도록 합니다.

이후: 새 도구를 사용하면 팀이 클릭 한 번으로 클라이언트에게 진행 상황 업데이트를 보낼 수 있습니다.

특정 행동을 명명할 수 없으면 사용자에게 물어보십시오. 다른 추상 동사로 그 간격을 덮지 마십시오.


12. 조밀한 단락 나누기

문제: 각각 고유한 단락을 가질 가치가 있는 여러 아이디어가 함께 포장된 텍스트의 벽. 독자의 눈이 쉴 곳이 없습니다.

경험 법칙: 단락당 하나의 아이디어. 아이디어가 바뀌면 새 단락을 시작하십시오 — 이전 단락이 두 문장뿐이더라도. 공백은 명확성을 위한 도구입니다.


프로세스

모든 입력에 대해:

  1. 먼저 전체를 읽으십시오. 핵심 요점을 파악하십시오. 핵심 요점이 명확하지 않다면, 그것이 가장 먼저 고쳐야 할 것입니다.
  2. 단락별로 다시 작성하십시오. 위의 패턴을 적용하십시오. 한 번에 모든 것을 고치려고 하지 마십시오 — 먼저 읽을 수 있게 만든 다음 다듬으십시오.
  3. 소리 내어 다시 읽으십시오 (머릿속으로 조용히). 문장이 당신을 막히게 하면 독자도 막히게 할 것입니다. 고치십시오.
  4. 자르십시오. 대부분의 재작성은 여전히 너무 깁니다. 정보 손실 없이 삭제할 수 있는 문장이 있는지 찾으십시오. 삭제하십시오.
  5. 구체적인 내용을 보존하십시오. 숫자, 이름, 날짜, 실제 의미가 있는 기술 용어 — 이것들을 유지하십시오. 명확성은 모호함과 동일하지 않습니다.
  6. 재작성만 출력하십시오. 서문, 설명 없이.

전체 작업 예제

입력:

지난 분기 동안 리더십 팀에 의해 수행된 최근 전략 검토와 조직 전반의 다양한 이해관계자들로부터 받은 여러 피드백을 고려하여, 우리의 자원을 전체 비즈니스 목표에 더 잘 맞추고 지속 가능한 장기 성장을 추진하기 위해, 앞으로 몇 주 동안 여러 운영 변경 사항을 시행할 것이 결정되었습니다. 여기에는 무엇보다도 특정 팀의 구조 조정, 보고 주기의 발전, 그리고 대규모로 교차 기능 협업을 촉진하고 전반적인 생산성을 향상시키도록 설계된 새로운 도구의 도입이 포함될 것입니다.

출력:

지난 분기에 리더십 팀은 전략 검토를 실행하고 회사 전반의 팀으로부터 피드백을 수집했습니다. 이를 바탕으로 우리는 목표에 자원을 더 잘 맞추기 위해 앞으로 몇 주에 걸쳐 세 가지 변경을 할 것입니다.

첫째, 일부 팀을 재구성할 것입니다. 둘째, 팀이 진행 상황을 보고하는 빈도를 변경할 것입니다. 셋째, 팀이 더 쉽게 협업할 수 있도록 새로운 도구를 도입할 것입니다.

그게 전부입니다. "변경 사항:" 섹션, 주석이 달린 차이점 없이. 재작성만 있습니다.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Jo5i4swastaken/Skills-Locker

Implements the "100% Retrieval Strategy" by Vercel. Injects a compressed docs index into AGENTS.md/CLAUDE.md to guarantee the agent always uses your global skills and best practices.

Jo5i4swastaken/Skills-Locker

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Jo5i4swastaken/Skills-Locker

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

Jo5i4swastaken/Skills-Locker

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

Jo5i4swastaken/Skills-Locker

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

Jo5i4swastaken/Skills-Locker

Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.

Jo5i4swastaken/Skills-Locker

Agent Media OS — resolve any media need (BGM, SFX, image, icon) into a frozen local file + ledger record. One verb (`resolve`) handles the full cascade — project cache, global cache, HeyGen catalog search, freeze, register. Keeps search noise on disk, hands the agent a path. Use when a composition needs background music, sound effects, images, or icons.

Jo5i4swastaken/Skills-Locker

Author a HyperFrames slideshow composition — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching sequences, and hotspot navigation. Use as an intent check when the user asks for a presentation, pitch deck, slide deck, interactive deck, or page-to-deck conversion that might be a slideshow; if the user did not explicitly ask for a slideshow / slide show, confirm before authoring.

Jo5i4swastaken/Skills-Locker

When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'TikTok video,' 'Reels,' 'Shorts,' 'video script,' 'video hook,' 'short-form video,' 'create a reel,' 'social listening,' 'brand mentions,' 'competitor monitoring,' 'top posts to comment on,' 'find people asking for,' 'carousel,' 'slide-by-slide,' or 'document post.' Use this for social media content creation, repurposing, scheduling, short-form video scripting, and social listening. For broader content strategy, see content-strategy. For paid ads, see ad-creative. For earned media, see public-relations.

Jo5i4swastaken/Skills-Locker

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS); Supabase CLI or MCP server; schema changes, migrations, security audits, Postgres extensions (pg_graphql, pg_cron, pg_vector).

Jo5i4swastaken/Skills-Locker

Watch a video (URL or local path). Downloads with yt-dlp, extracts auto-scaled frames with ffmpeg, pulls the transcript from captions (or Whisper API fallback), and hands the result to Claude so it can answer questions about what's in the video.

관련 스킬