← 스킬 목록으로 돌아가기

readability-scorer

v1.0.1 approved Text Processing 오늘 업데이트
USK v3 ✅ Verified ⚡ Auto-Convert
⬇ 다운로드
설치 가이드↓
🤖 에이전트용 설치 명령 (curl / MCP / Claude Desktop)
▸ curl 한 줄 다운로드
curl -L -o readability-scorer.skill   "https://aiskillstore.io/v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=ClaudeCode"
▸ MCP 도구 호출 (Skill Store MCP 등록 시)
{
  "tool": "download_skill",
  "arguments": {
    "skill_id": "0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f",
    "platform": "ClaudeCode"
  }
}
▸ Claude Desktop / Cursor MCP 설정 (1회)
{
  "mcpServers": {
    "skill-store": {
      "url": "https://aiskillstore.io/mcp/"
    }
  }
}
📖 에이전트용 전체 API 가이드: /llms.txt  ·  MCP server card

Readability scoring for English and Korean text. 5 actions: score, compare, suggest_improvements, audit, segment. Zero external dependencies. Flesch-Kincaid + Korean heuristics.

# readability # flesch-kincaid # korean # text-analysis # writing-quality # content-audit # text-processing

기본 정보

소유자 👤 aiskillstore-team 카테고리 Text Processing 등록일 2026-05-05 최종 업데이트 2026-05-05 최신 버전 1.0.1 패키지 날짜 2026-05-05 검증 상태 approved 다운로드 수 0회 체크섬 (SHA256) afd35af054dbd98dc7a71bda3f49b39480c4f183f865fea23a0a3151851df8a5

⚡ AGENT INFO USK v3

Capabilities
readability_scoring flesch_kincaid korean_readability text_simplification_suggestions audit
Permissions
✗ network
✗ filesystem
✗ subprocess
Interface
type: cli   entry_point: main.py   runtime: python3   call_pattern: stdin_stdout
Agent API
# 스킬 스키마 조회 (에이전트가 호출 방법을 파악) GET /v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/schema # 플랫폼별 자동 변환 다운로드 GET /v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=OpenClaw GET /v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=ClaudeCode GET /v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=ClaudeCodeAgentSkill GET /v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=Cursor GET /v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=GeminiCLI GET /v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=CodexCLI GET /v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=CustomAgent

설치 방법

호환 플랫폼: any

1
openclaw_skill_manager.py로 스킬을 설치합니다.
python openclaw_skill_manager.py --install readability-scorer
2
설치 확인
python openclaw_skill_manager.py --list-installed
3
특정 버전 설치 (선택)
python openclaw_skill_manager.py --install readability-scorer --version 1.0.1
1
스킬 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download
2
Claude Code commands 디렉터리에 배치합니다.
unzip readability-scorer.skill -d ~/.claude/commands/readability-scorer/
3
Claude Code에서 슬래시 커맨드로 사용합니다.
/readability-scorer
1
Agent Skills 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=ClaudeCodeAgentSkill
2
Claude Code skills 디렉터리에 압축을 해제합니다.
unzip readability-scorer-agent-skill-*.skill -d ~/.claude/skills/readability-scorer/
3
Claude Code를 재시작하면 세션 시작 시 자동으로 로드됩니다. 슬래시 커맨드 없이 자연어로 사용 가능합니다.
1
Cursor 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=Cursor
2
압축 해제 후 영구 위치에 저장합니다.
unzip readability-scorer-cursor-*.skill -d ~/.cursor/skills/readability-scorer/
3
.cursor/mcp.json에 MCP 서버 설정을 추가하고 Cursor를 재시작합니다.
cat ~/.cursor/skills/readability-scorer/cursor_mcp_config.json
1
Gemini CLI 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=GeminiCLI
2
압축 해제 후 영구 위치에 저장합니다.
unzip readability-scorer-geminicli-*.skill -d ~/.gemini/skills/readability-scorer/
3
~/.gemini/settings.json에 MCP 서버 설정을 추가하고 Gemini CLI를 재시작합니다.
cat ~/.gemini/skills/readability-scorer/gemini_settings_snippet.json
1
Codex CLI 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=CodexCLI
2
압축 해제 후 영구 위치에 저장합니다.
unzip readability-scorer-codexcli-*.skill -d ~/.codex/skills/readability-scorer/
3
~/.codex/config.toml에 MCP 서버 설정을 추가하고 Codex CLI를 재시작합니다.
cat ~/.codex/skills/readability-scorer/codex_config_snippet.toml
1
REST API로 스킬 패키지를 다운로드합니다.
GET https://aiskillstore.io/v1/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download
2
에이전트 플랫폼의 skills 디렉터리에 배치합니다.
cp readability-scorer.skill ./skills/
3
설치 가이드 API로 플랫폼별 상세 정보를 조회합니다.
GET https://aiskillstore.io/v1/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/install-guide?platform=CustomAgent

보안 검증 보고서

검증 결과 APPROVED

검사 결과: ["메타데이터 경고: 권장 필드 없음: 'requirements' (SKILL.md v2 권장)", "메타데이터 경고: 권장 필드 없음: 'changelog' (SKILL.md v2 권장)"]

✅ 보안 위험 항목이 발견되지 않았습니다.

AI 검수 단계

검수 주체 gemini 위험도 🟢 낮음 검수 요약 선언된 권한을 준수하며, 악의적인 동작이나 외부 통신이 없는 안전한 스킬입니다.
판단 근거

스킬 메타데이터에 명시된 'network: false', 'filesystem: false', 'subprocess: false' 권한 선언과 실제 코드의 동작이 완벽하게 일치합니다. 코드 분석 결과, 외부 네트워크 통신, 파일 시스템 접근, 서브프로세스 실행 등 선언되지 않은 어떠한 위험한 동작도 발견되지 않았습니다. 입력은 stdin으로 받고 출력은 stdout으로만 처리하며, 모든 로직은 인메모리 텍스트 처리 및 계산으로 이루어져 있습니다. 정적 분석 결과 또한 'approved' 상태로, 악의적인 코드나 난독화, 금지된 실행 파일 등이 발견되지 않았음을 확인했습니다. 코드 품질은 스킬의 목적에 부합하며, 'Zero external dependencies'라는 설명대로 표준 라이브러리 외의 외부 의존성이 없습니다. 따라서 이 스킬은 안전하며 즉시 공개 가능합니다.

버전 히스토리

버전 USK v3 검증 상태 패키지 날짜 다운로드 변경사항
v1.0.1 approved 2026-05-05 ⬇ 0
v1.0.0 approved 2026-05-05 ⬇ 0

사용 예시 (Examples) 8 개

이 스킬의 대표적인 입출력 예시입니다. 에이전트는 이 예시를 보고 스킬 호출 방법과 결과 형태를 이해할 수 있습니다.

score_english_simple
# score# english# easy

영어 텍스트 가독성 점수 / Score English text readability

📥 입력
{
  "action": "score",
  "lang": "en",
  "text": "The cat sat on the mat. It was a sunny day. The birds sang in the trees."
}
📤 출력
{
  "action": "score",
  "lang": "en",
  "level": "very_easy",
  "scores": {
    "avg_sentence_words": 7.0,
    "avg_word_syllables": 1.2,
    "flesch_kincaid_grade": 2.8,
    "flesch_reading_ease": 87.5,
    "gunning_fog": 3.2,
    "long_sentence_ratio": 0.0
  },
  "stats": {
    "char_count": 72,
    "paragraph_count": 1,
    "sentence_count": 3,
    "word_count": 21
  },
  "summary": "\ub9e4\uc6b0 \uc77d\uae30 \uc26c\uc6b4 \ud14d\uc2a4\ud2b8\uc785\ub2c8\ub2e4 (\ucd08\ub4f1\ud559\uad50 \uc218\uc900) / Very easy to read (elementary level)"
}
score_korean_simple
# score# korean# easy

한국어 텍스트 가독성 점수 / Score Korean text readability

📥 입력
{
  "action": "score",
  "lang": "ko",
  "text": "\uc624\ub298\uc740 \ub0a0\uc528\uac00 \ub9d1\uc2b5\ub2c8\ub2e4. \ud558\ub298\uc774 \ud30c\ub797\uace0 \uad6c\ub984\uc774 \uc5c6\uc2b5\ub2c8\ub2e4. \uc0b0\ucc45\ud558\uae30 \uc88b\uc740 \ub0a0\uc785\ub2c8\ub2e4."
}
📤 출력
{
  "action": "score",
  "lang": "ko",
  "level": "very_easy",
  "scores": {
    "avg_sentence_words": 4.0,
    "hanja_ratio": 0.0,
    "korean_readability": 88.0,
    "long_sentence_ratio": 0.0
  },
  "stats": {
    "char_count": 45,
    "paragraph_count": 1,
    "sentence_count": 3,
    "word_count": 12
  },
  "summary": "\ub9e4\uc6b0 \uc77d\uae30 \uc26c\uc6b4 \ud55c\uad6d\uc5b4 \ud14d\uc2a4\ud2b8\uc785\ub2c8\ub2e4 / Very easy Korean text"
}
score_korean_hanja_heavy
# score# korean# hanja# difficult

한자 비율 높은 한국어 텍스트 감지 / Detect high Hanja ratio in Korean text

📥 입력
{
  "action": "score",
  "lang": "ko",
  "text": "\u672c \u784f\u7a76\ub294 \u8a8d\u77e5\u79d1\u5b78\u7684 \u89c0\u9ede\uc5d0\uc11c \u8a00\u8a9e \u7fd2\u5f97 \u6a5f\u5236\ub97c \u5206\u6790\ud55c \u7d50\u679c\ub97c \u63d0\u793a\ud55c\ub2e4."
}
📤 출력
{
  "action": "score",
  "lang": "ko",
  "level": "difficult",
  "scores": {
    "avg_sentence_words": 8.0,
    "hanja_ratio": 0.65,
    "korean_readability": 42.0,
    "long_sentence_ratio": 0.0
  },
  "stats": {
    "char_count": 40,
    "paragraph_count": 1,
    "sentence_count": 1,
    "word_count": 8
  },
  "summary": "\ud55c\uc790 \ube44\uc728\uc774 \ub192\uc544 \uc77d\uae30 \uc5b4\ub835\uc2b5\ub2c8\ub2e4 / High Hanja ratio makes this text difficult"
}
compare_texts
# compare# english# contrast

두 텍스트 가독성 비교 / Compare readability of two texts

📥 입력
{
  "action": "compare",
  "lang": "en",
  "texts": [
    "The quick brown fox jumps over the lazy dog.",
    "The expeditious tawny vulpine mammal executed a prodigious vault over the indolent canine."
  ]
}
📤 출력
{
  "action": "compare",
  "comparisons": [
    {
      "index": 0,
      "level": "easy",
      "summary": "\uc77d\uae30 \uc26c\uc6b4 \ud14d\uc2a4\ud2b8 / Easy to read"
    },
    {
      "index": 1,
      "level": "difficult",
      "summary": "\uc5b4\ub824\uc6b4 \ub2e8\uc5b4\uac00 \ub9ce\uc544 \uc77d\uae30 \uc5b4\ub835\uc2b5\ub2c8\ub2e4 / Difficult due to complex vocabulary"
    }
  ],
  "lang": "en"
}
suggest_improvements
# suggest# english# complex

가독성 개선 제안 생성 / Generate readability improvement suggestions

📥 입력
{
  "action": "suggest_improvements",
  "lang": "en",
  "target_grade": 8,
  "text": "The implementation of the aforementioned functionality necessitates the utilization of sophisticated algorithmic methodologies that fundamentally transform the underlying computational paradigm."
}
📤 출력
{
  "action": "suggest_improvements",
  "lang": "en",
  "suggestions": [
    {
      "fix_hint": {
        "action": "split",
        "location": "sentence_1",
        "reference": "50/72 word limit for business writing",
        "suggested_replacement": "Break into 2-3 shorter sentences"
      },
      "message": "\uc774 \ubb38\uc7a5\uc740 30\ub2e8\uc5b4\ub97c \ucd08\uacfc\ud569\ub2c8\ub2e4 \u2014 \ubd84\ud560\uc744 \uad8c\uc7a5\ud569\ub2c8\ub2e4 / Sentence exceeds 30 words \u2014 consider splitting",
      "severity": "high",
      "type": "long_sentence"
    },
    {
      "fix_hint": {
        "action": "simplify",
        "location": "vocabulary",
        "reference": "Plain language guidelines",
        "suggested_replacement": "Replace \u0027aforementioned\u0027 with \u0027this\u0027, \u0027necessitates\u0027 with \u0027needs\u0027"
      },
      "message": "\ubcf5\uc7a1\ud55c \ub2e8\uc5b4 \ube44\uc728\uc774 \ub192\uc2b5\ub2c8\ub2e4 \u2014 \uc26c\uc6b4 \ud45c\ud604\uc73c\ub85c \uad50\uccb4 \uad8c\uc7a5 / High ratio of complex words \u2014 use simpler alternatives",
      "severity": "medium",
      "type": "complex_vocabulary"
    }
  ]
}
audit_text
# audit# korean# formal

텍스트 가독성 감사 / Audit text for readability issues

📥 입력
{
  "action": "audit",
  "lang": "ko",
  "text": "\uc6b0\ub9ac \ud68c\uc0ac\uc758 \uc2e0\uc81c\ud488 \ucd9c\uc2dc\uc640 \uad00\ub828\ud558\uc5ec \uadc0\uc0ac\uc758 \uae0d\uc815\uc801\uc778 \ud611\uc870 \ubc0f \uc9c0\uc6d0\uc744 \ubd80\ud0c1\ub4dc\ub9ac\ub294 \ubc14\uc774\uc624\uba70, \ud5a5\ud6c4 \uc9c4\ud589\ub420 \ub2e4\uc591\ud55c \ub9c8\ucf00\ud305 \ud65c\ub3d9\uc5d0 \uc788\uc5b4\uc11c\ub3c4 \uc0c1\ud638 \ud611\ub825\uc801\uc778 \uad00\uacc4\ub97c \uc9c0\uc18d\uc801\uc73c\ub85c \uc720\uc9c0\ud574 \ub098\uac00\uae30\ub97c \ud76c\ub9dd\ud558\ub294 \ubc14\uc785\ub2c8\ub2e4."
}
📤 출력
{
  "action": "audit",
  "audit_score": 45,
  "issues": [
    {
      "fix_hint": {
        "action": "split",
        "location": "sentence_1",
        "reference": "\ud55c\uad6d\uc5b4 \uac00\ub3c5\uc131 \uae30\uc900: 15-20\uc5b4\uc808 \uad8c\uc7a5",
        "suggested_replacement": "\ub450 \ubb38\uc7a5\uc73c\ub85c \ubd84\ud560 \uad8c\uc7a5"
      },
      "message": "\ubb38\uc7a5\uc774 30\uc5b4\uc808\uc744 \ucd08\uacfc\ud569\ub2c8\ub2e4 \u2014 \ubd84\ud560 \ud544\uc694 / Sentence exceeds 30 words \u2014 split required",
      "rule": "LONG_SENTENCE",
      "severity": "error"
    },
    {
      "fix_hint": {
        "action": "simplify",
        "location": "sentence_endings",
        "reference": "\uc26c\uc6b4 \uacf5\uacf5\uc5b8\uc5b4 \uc4f0\uae30 \uc9c0\uce68",
        "suggested_replacement": "\u0027\ud611\uc870\ud574 \uc8fc\uc138\uc694\u0027, \u0027\uc720\uc9c0\ud558\uaca0\uc2b5\ub2c8\ub2e4\u0027"
      },
      "message": "\u0027~\ud558\ub294 \ubc14\uc774\uc624\uba70\u0027, \u0027~\ubc14\uc785\ub2c8\ub2e4\u0027 \ub4f1 \uacfc\ub3c4\ud55c \uaca9\uc2dd\uccb4 \u2014 \uac04\uacb0\ud55c \ud45c\ud604 \uad8c\uc7a5 / Overly formal endings detected",
      "rule": "FORMAL_EXCESS",
      "severity": "warning"
    }
  ],
  "lang": "ko"
}
segment_analysis
# segment# english# paragraph

단락별 가독성 분석 / Per-paragraph readability analysis

📥 입력
{
  "action": "segment",
  "lang": "en",
  "segment_unit": "paragraph",
  "text": "Simple text here.\n\nThis is a much more complicated paragraph with many difficult words and long sentences that go on and on."
}
📤 출력
{
  "action": "segment",
  "lang": "en",
  "segments": [
    {
      "index": 0,
      "level": "very_easy",
      "text": "Simple text here."
    },
    {
      "index": 1,
      "level": "medium",
      "text": "This is a much more complicated paragraph..."
    }
  ]
}
score_auto_detect
# score# auto-detect# korean

언어 자동 감지 후 점수 계산 / Auto-detect language and score

📥 입력
{
  "action": "score",
  "text": "\uc778\uacf5\uc9c0\ub2a5 \uae30\uc220\uc740 \ud604\ub300 \uc0ac\ud68c\uc5d0\uc11c \ub9e4\uc6b0 \uc911\uc694\ud55c \uc5ed\ud560\uc744 \ud569\ub2c8\ub2e4. AI\ub294 \uc758\ub8cc, \uad50\uc721, \uae08\uc735 \ubd84\uc57c\uc5d0\uc11c \ub110\ub9ac \ud65c\uc6a9\ub429\ub2c8\ub2e4."
}
📤 출력
{
  "action": "score",
  "lang": "ko",
  "level": "medium",
  "scores": {
    "avg_sentence_words": 9.0,
    "hanja_ratio": 0.0,
    "korean_readability": 75.0,
    "long_sentence_ratio": 0.0
  },
  "summary": "\uc911\uac04 \uc218\uc900\uc758 \ud55c\uad6d\uc5b4 \ud14d\uc2a4\ud2b8\uc785\ub2c8\ub2e4 / Medium difficulty Korean text"
}

모든 예시는 에이전트 API로도 조회 가능: /v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/schema

리뷰 & 평점

아직 리뷰가 없습니다. 첫 번째 리뷰를 남겨보세요!

✍️ 리뷰 작성