← Back to Skills

readability-scorer

v1.0.0 approved Text Processing updated today
USK v3 🔲 Sandbox ⚡ Auto-Convert
⬇ Download
Install Guide↓
🤖 Agent install commands (curl / MCP / Claude Desktop)
▸ curl one-liner
curl -L -o readability-scorer.skill   "https://aiskillstore.io/v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=ClaudeCode"
▸ MCP tool call (after registering Skill Store MCP)
{
  "tool": "download_skill",
  "arguments": {
    "skill_id": "0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f",
    "platform": "ClaudeCode"
  }
}
▸ Claude Desktop / Cursor MCP config (one-time)
{
  "mcpServers": {
    "skill-store": {
      "url": "https://aiskillstore.io/mcp/"
    }
  }
}
📖 Full agent API guide: /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

Basic Info

Owner 👤 aiskillstore-team Category Text Processing Registered 2026-05-05 Last Updated 2026-05-05 Latest Version 1.0.0 Packaged At 2026-05-05 Vetting Status approved Downloads 0 Checksum (SHA256) 1d11d7a884a0d8350585a51b1387f91c63518d63a3fb91ff943e450d4333478a

⚡ 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

Installation

Compatible Platforms any

1
Install the skill using openclaw_skill_manager.py.
python openclaw_skill_manager.py --install readability-scorer
2
Verify installation
python openclaw_skill_manager.py --list-installed
3
Install a specific version (optional)
python openclaw_skill_manager.py --install readability-scorer --version 1.0.0
1
Download the skill package.
curl -O https://aiskillstore.io/v1/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download
2
Place it in the Claude Code commands directory.
unzip readability-scorer.skill -d ~/.claude/commands/readability-scorer/
3
Use it as a slash command in Claude Code.
/readability-scorer
1
Download the Agent Skills package.
curl -O https://aiskillstore.io/v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=ClaudeCodeAgentSkill
2
Unzip it into the Claude Code skills directory.
unzip readability-scorer-agent-skill-*.skill -d ~/.claude/skills/readability-scorer/
3
Restart Claude Code — the skill is auto-loaded at session start. No slash command needed.
1
Download the Cursor-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=Cursor
2
Unzip and place it in a permanent location.
unzip readability-scorer-cursor-*.skill -d ~/.cursor/skills/readability-scorer/
3
Add the MCP server config to .cursor/mcp.json, then restart Cursor.
cat ~/.cursor/skills/readability-scorer/cursor_mcp_config.json
1
Download the Gemini CLI-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=GeminiCLI
2
Unzip and place it in a permanent location.
unzip readability-scorer-geminicli-*.skill -d ~/.gemini/skills/readability-scorer/
3
Add the MCP server config to ~/.gemini/settings.json, then restart Gemini CLI.
cat ~/.gemini/skills/readability-scorer/gemini_settings_snippet.json
1
Download the Codex CLI-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download?platform=CodexCLI
2
Unzip and place it in a permanent location.
unzip readability-scorer-codexcli-*.skill -d ~/.codex/skills/readability-scorer/
3
Add the MCP server config to ~/.codex/config.toml, then restart Codex CLI.
cat ~/.codex/skills/readability-scorer/codex_config_snippet.toml
1
Download the skill package via REST API.
GET https://aiskillstore.io/v1/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/download
2
Place it in your agent platform's skills directory.
cp readability-scorer.skill ./skills/
3
Fetch platform-specific details via the Install Guide API.
GET https://aiskillstore.io/v1/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/install-guide?platform=CustomAgent

Security Vetting Report

Vetting Result CAUTION

🚨 Security risks detected:

  • main.py: __import__(

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

AI Review Stage

Reviewer gemini Risk Level 🟢 Low Review Summary 선언된 `filesystem: false` 권한과 `os` 모듈 사용 간의 미묘한 불일치로 인해 관리자 검토가 필요합니다.

Issues Found

  • 스킬 메타데이터에 `permissions.filesystem: false`로 선언되어 있으나, `main.py`에서 `sys.path.insert(0, __import__("os").path.dirname(__file__))` 코드를 통해 `os` 모듈을 사용하여 파일 시스템 경로 정보를 읽고 있습니다. 이는 엄격한 의미에서 파일 시스템 접근으로 간주될 수 있습니다.
Reasoning

스킬은 텍스트 가독성 분석이라는 명확한 목적을 가지고 있으며, 제공된 코드와 메타데이터는 이 목적에 부합합니다. `network: false`, `subprocess: false`, `env_vars: []` 권한은 코드에서 위반되는 부분이 발견되지 않았습니다. 또한, 사용자 데이터를 무단으로 수집하거나 전송하는 악의적인 코드는 발견되지 않았습니다. 'Zero external dependencies'라는 설명도 표준 라이브러리만 사용하는 것으로 보아 충족됩니다. 그러나 정적 분석 결과에서 `main.py: __import__("`가 위험 신호로 감지되었으며, 이는 `sys.path.insert(0, __import__("os").path.dirname(__file__))` 라인과 관련이 있습니다. 이 코드는 `os` 모듈을 사용하여 현재 스크립트의 디렉토리 경로를 얻어 `sys.path`에 추가하는 것으로, 로컬 `lib` 모듈을 임포트하기 위한 일반적이고 합법적인 방법입니다. 하지만 `permissions.filesystem: false`로 명시적으로 선언된 상황에서, 자신의 파일 경로를 읽는 행위조차도 파일 시스템 접근으로 간주될 수 있습니다. 이는 악의적인 목적의 파일 시스템 접근은 아니지만, 선언된 권한과의 기술적인 불일치로 인해 플랫폼의 엄격한 샌드박스 정책에 따라 관리자의 추가적인 검토가 필요하다고 판단됩니다. 전반적인 기능과 코드 내용은 안전해 보이며, 이 불일치로 인한 실제 보안 위험은 낮습니다.

Version History

Version USK v3 Vetting Status Packaged At Downloads Changelog
v1.0.0 approved 2026-05-05 ⬇ 0

Examples 8

Representative input/output examples for this skill. Agents can use these to understand how to invoke the skill and what output to expect.

score_english_simple
# score# english# easy

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

📥 Input
{
  "action": "score",
  "lang": "en",
  "text": "The cat sat on the mat. It was a sunny day. The birds sang in the trees."
}
📤 Output
{
  "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

📥 Input
{
  "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."
}
📤 Output
{
  "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

📥 Input
{
  "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."
}
📤 Output
{
  "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

📥 Input
{
  "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."
  ]
}
📤 Output
{
  "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

📥 Input
{
  "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."
}
📤 Output
{
  "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

📥 Input
{
  "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."
}
📤 Output
{
  "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

📥 Input
{
  "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."
}
📤 Output
{
  "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

📥 Input
{
  "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."
}
📤 Output
{
  "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"
}

All examples are also available via the agent API: /v1/agent/skills/0c8c7592-5a7a-4ed4-afff-ca3e9f303a3f/schema

Reviews & Ratings

No reviews yet. Be the first to leave one!

✍️ Write a Review