AgentHubAgentHub

character-refs Skill Install & Guide

SkillGitHub 中文

io.github.eternityspring/shuohao-skills/character-refs

给任何故事里的角色真出参考图（小说改编、自己原创的故事、单独设计一个角色都行，不需要小说原文）： 一段话描述角色，拆成分层字段、补全后确认， 先出一张正面全身锚点，其余视图（大头照、90° 侧面、背面、细节、45° 大头照）都只参考这张锚点， 按需分档出图。每张图带标识、可单独重出，重出后自动标出哪些图过期。 支持 Qwen Image（ComfyUI）、codex 内置出图、OpenAI Images API（GPT Image 2）和自定义命令，主图与派生图可以使用不同模型。 产出 asset.json + 一组 PNG + 双击就能开的报告。零依赖。 只要提示词、不出图的话使用 novel-characters。 Use when asked to 出角色图、做角色参考图、给我的角色出图、定妆照、真出三视图、character reference images。

View on GitHub 中文 ↗Repository ↗

Copy the install config on this page first, then verify docs and permissions upstream.

Overview

给任何故事里的角色真出参考图（小说改编、自己原创的故事、单独设计一个角色都行，不需要小说原文）： 一段话描述角色，拆成分层字段、补全后确认， 先出一张正面全身锚点，其余视图（大头照、90° 侧面、背面、细节、45° 大头照）都只参考这张锚点， 按需分档出图。每张图带标识、可单独重出，重出后自动标出哪些图过期。 支持 Qwen Image（ComfyUI）、codex 内置出图、OpenAI Images API（GPT Image 2）和自定义命令，主图与派生图可以使用不同模型。 产出 asset.json + 一组 PNG + 双击就能开的报告。零依赖。 只要提示词、不出图的话使用 novel-characters。 Use when asked to 出角色图、做角色参考图、给我的角色出图、定妆照、真出三视图、character reference images。 character-refs is a Agent Skill listed from GitHub CN. This page includes an overview, setup tutorial, install commands, and use cases for Trae, Tongyi Lingma, Cursor, Claude Code, and VS Code.

Use cases

Code review & GitHubFilesystem & local projectsCursor essentials

AgentHub Verified AvailabilityTested & Ready

Automated pipeline validated install commands, protocol & client compatibility

Verified At2026-10-30
Install Snippets TestedCLI & JSON config syntax verified
Protocol Handshake ReadyComplies with JSON-RPC 2.0 specifications
Origin Registry ActiveSourced from github-cn
Verified ClientsClaude Code、Claude Desktop、Cursor 等
Security Tier: A+ 级 · 零权限本地沙盒 (A+)·Scanned for high-risk vulnerabilities. Recommended to run with project-scoped permissions.

Send this prompt to your AI to install the Skill

Recommended
Target client (auto-optimizes prompt):
PROMPT >

Follow the install guide at https://myagenthub.cn/install/skill.md?lang=en to automatically detect the current IDE and install the skill "eternityspring/shuohao-skills@character-refs" without asking, and tell me how to verify it afterwards.

💡Paste into your AI coding assistant (Cursor, Trae, Claude Code) — the agent will handle download and configuration automatically.

Copy by platformAlternative

Choose your platform

Choose install method

Click to copy snippet
# 改 -a 切换客户端：trae | lingma | codebuddy | kimi-code-cli | qwen-code | cursor | claude-code | windsurf | cline | github-copilot | codex
npx skills add eternityspring/shuohao-skills@character-refs -a cursor -y

Setup tutorial

  1. Open the character-refs page and confirm the source is GitHub CN.
  2. Copy the install command for Trae, Lingma, Cursor, Claude Code, or universal CLI.
  3. Run it, or place SKILL.md under .trae/skills/, .lingma/skills/, or .cursor/skills/.
  4. Reload the client, then describe your task so the agent can match this skill.

Install commands

Install commands and setup steps are in the HTML so search engines and no-JS browsers can read them without running client JavaScript.

Universal — Skills CLI (recommended)

Skills CLI

# 改 -a 切换客户端：trae | lingma | codebuddy | kimi-code-cli | qwen-code | cursor | claude-code | windsurf | cline | github-copilot | codex
npx skills add eternityspring/shuohao-skills@character-refs -a cursor -y

AgentHub CLI (change --ai)

# 改 --ai 切换客户端：trae | lingma | workbuddy | kimi | qwen | cursor | claude-code | windsurf | cline | vscode | codex | openclaw
curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init eternityspring/shuohao-skills@character-refs --ai cursor -y

Cursor

Skills CLI

npx skills add eternityspring/shuohao-skills@character-refs -a cursor -y

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init eternityspring/shuohao-skills@character-refs --ai cursor -y

Project directory

mkdir -p .cursor/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o .cursor/skills/character-refs/SKILL.md
# 如有 scripts/ references/ assets/ 请一并复制

User directory

mkdir -p ~/.cursor/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o ~/.cursor/skills/character-refs/SKILL.md

Trae (ByteDance)

  1. Trae natively supports Skill specs: project-level in .trae/skills/<name>/, global in ~/.trae/skills/
  2. Copy and run the command in your project terminal to download SKILL.md
  3. Reload Trae window, then describe your task in AI chat to activate automatically

Skills CLI

npx skills add eternityspring/shuohao-skills@character-refs -a trae -y

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init eternityspring/shuohao-skills@character-refs --ai trae -y

Project directory

mkdir -p .trae/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o .trae/skills/character-refs/SKILL.md

User directory

mkdir -p ~/.trae/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o ~/.trae/skills/character-refs/SKILL.md

Tongyi Lingma (Alibaba)

  1. Tongyi Lingma supports skills in project .lingma/skills/<name>/ or global ~/.lingma/skills/
  2. Run the command to install SKILL.md
  3. In Lingma Agent mode, prompt your task and the skill will be automatically loaded

Skills CLI

npx skills add eternityspring/shuohao-skills@character-refs -a lingma -y

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init eternityspring/shuohao-skills@character-refs --ai lingma -y

Project directory

mkdir -p .lingma/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o .lingma/skills/character-refs/SKILL.md

User directory

mkdir -p ~/.lingma/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o ~/.lingma/skills/character-refs/SKILL.md

WorkBuddy / CodeBuddy (Tencent)

  1. WorkBuddy reads skills only from .workbuddy/skills/<name>/ (user-level ~/.workbuddy/skills/); .codebuddy/skills/ belongs to CodeBuddy
  2. The Skills CLI command installs with -a codebuddy and appends a copy step into .workbuddy/skills
  3. AgentHub CLI (--ai workbuddy) syncs it for you; reload the chat panel so the skill gets indexed

Skills CLI

npx skills add eternityspring/shuohao-skills@character-refs -a codebuddy -y
# WorkBuddy 读取 .workbuddy/skills，把上游写入 .codebuddy/skills 的结果同步一份
mkdir -p .workbuddy/skills && cp -R .codebuddy/skills/character-refs .workbuddy/skills/

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init eternityspring/shuohao-skills@character-refs --ai workbuddy -y

Project directory

mkdir -p .workbuddy/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o .workbuddy/skills/character-refs/SKILL.md

Claude Code

Project directory

mkdir -p .claude/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o .claude/skills/character-refs/SKILL.md

User directory

mkdir -p ~/.claude/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o ~/.claude/skills/character-refs/SKILL.md

Skills CLI

npx skills add eternityspring/shuohao-skills@character-refs -a claude-code -y

Kimi Code (Moonshot AI)

  1. Kimi Code supports standard Agent Skills: project-level in .agents/skills/<name>/, global in ~/.agents/skills/
  2. Run the command to install
  3. In Kimi Code CLI, describe your task to trigger the skill

Skills CLI

npx skills add eternityspring/shuohao-skills@character-refs -a kimi-code-cli -y

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init eternityspring/shuohao-skills@character-refs --ai kimi -y

Project directory

mkdir -p .agents/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o .agents/skills/character-refs/SKILL.md

User directory

mkdir -p ~/.agents/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o ~/.agents/skills/character-refs/SKILL.md

Qwen Code (Alibaba)

  1. Qwen Code supports project .qwen/skills/<name>/ and global ~/.qwen/skills/
  2. Run the command to deploy SKILL.md
  3. Prompt the agent to trigger the skill

Skills CLI

npx skills add eternityspring/shuohao-skills@character-refs -a qwen-code -y

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init eternityspring/shuohao-skills@character-refs --ai qwen -y

Project directory

mkdir -p .qwen/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o .qwen/skills/character-refs/SKILL.md

User directory

mkdir -p ~/.qwen/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o ~/.qwen/skills/character-refs/SKILL.md

Windsurf

  1. Windsurf supports project-level .windsurf/skills/<name>/ or global ~/.codeium/windsurf/skills/
  2. Run the install command and refresh Cascade
  3. Cascade will auto-activate the skill based on its description

Skills CLI

npx skills add eternityspring/shuohao-skills@character-refs -a windsurf -y

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init eternityspring/shuohao-skills@character-refs --ai windsurf -y

Project directory

mkdir -p .windsurf/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o .windsurf/skills/character-refs/SKILL.md

User directory

mkdir -p ~/.codeium/windsurf/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o ~/.codeium/windsurf/skills/character-refs/SKILL.md

Cline

  1. Cline supports standard .agents/skills/<name>/ structure
  2. Run the command to install the skill
  3. Ask questions in the Cline panel to trigger the skill

Skills CLI

npx skills add eternityspring/shuohao-skills@character-refs -a cline -y

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init eternityspring/shuohao-skills@character-refs --ai cline -y

Project directory

mkdir -p .agents/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o .agents/skills/character-refs/SKILL.md

Cherry Studio

  1. Use this skill as an Assistant system prompt in Cherry Studio
  2. Copy the command to view SKILL.md text
  3. Paste the contents into Cherry Studio Assistant system prompt
# 打印 SKILL.md 指令内容并粘贴到 Cherry Studio 智能体系统提示词中
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md"

VS Code / GitHub Copilot

mkdir -p .github/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o .github/skills/character-refs/SKILL.md

OpenAI Codex

Skills CLI

npx skills add eternityspring/shuohao-skills@character-refs -a codex -g -y

User directory

mkdir -p ~/.codex/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o ~/.codex/skills/character-refs/SKILL.md

Project directory

mkdir -p .agents/skills/character-refs
RAW="https://raw.githubusercontent.com/eternityspring/shuohao-skills/main/skills/character-refs"
curl -sL "$RAW/SKILL.md" -o .agents/skills/character-refs/SKILL.md

Troubleshooting & Common ErrorsFAQ

Common connection errors and verified fixes for character-refs

Getting 'connection closed' or exit code 1 in Cursor / Claude Code for character-refs?

Usually caused by missing runtime paths or IDE environment inheritance. Fix steps: 1. Verify Node.js 18+ (npx) or Python 3.10+ (uvx) is installed; 2. Run 'which npx' or 'which uvx' in terminal, and replace 'command' with absolute path; 3. Reload or restart the client window after modifying config.

Fix Snippet
# Check binary path in terminal:
which npx
node -v
Getting 'spawn npx ENOENT' or 'command not found'?

The editor background process does not inherit your full terminal PATH. Solution: Globally install the package, or set the absolute binary path (e.g. C:\Program Files\nodejs\npx.cmd on Windows, or /usr/local/bin/npx on macOS).

Tool calls timing out or failing to download packages?

First-time package downloading might be slow or timeout due to network limits. Configure a reliable mirror or check outbound proxy settings.

Agent does not match or apply character-refs during conversations?

Verify SKILL.md is located at .cursor/skills/character-refs/SKILL.md (Cursor) or ~/.claude/skills/character-refs/SKILL.md (Claude Code). You can explicitly mention the skill name in your prompt to boost match confidence.

Still not connecting? Read the MCP troubleshooting guide →

Tool Mock Playground

Sandbox

character-refs Rule Injection & Agent Behavior Simulation · Preview tool schema & outputs without local runtime

Sandbox Ready
fn: agent_skill_runtimeInject system prompt guidelines & workflow constraints from character-refs
Request ArgumentsJSON Schema
{
  "skill": "character-refs",
  "rulePath": ".cursor/skills/character-refs/SKILL.md",
  "userGoal": "请使用 character-refs 的方法与标准帮我完成当前任务",
  "client": "Cursor / Claude Code"
}
💡Parameters generated dynamically by Agent runtime
Agent Tool Output

Click 'Run Mock' above

to preview the raw response returned to the LLM

Env: AgentHub Virtual SandboxJSON-RPC 2.0

Decision Guide: Why & When to Use

Assess suitability before installing to save trial-and-error time

Best Suited For
  • PR review
  • Changelog generation
  • Cross-repo issue search
When NOT to Use
  • Replacing human security audit
  • Unauthorized repo access
Recommended Workflow Pairing:View Scenario →

character-refs + Scenario Prompt → Complete Agent Automation

Skill hands-on: install to visible results

Follow the full lab (expected UI/output + contrast checks). After installing this item, verify with the tutorial prompts.

Open tutorial →

An Agent Skill is a folder with SKILL.md instructions. After install, the AI loads it automatically when your task matches its description.

How to use

After installing, describe your task in chat (or mention the skill name). The agent reads the skill description to decide when to activate it, then follows the instructions in SKILL.md. Check loaded skills via /skills in Claude Code or in your client settings.

Related resources

中文公文写作

v2.0.46

SkillClawHub7210.6k

io.clawhub.gongyu0918-debug/chinese-official-writing

用于中文公文、事务性材料和新闻稿件的起草、改写、压缩、润色、审校、文种核对、去口语化、降 AI 味及 Word 格式处理，适用于机关、企事业单位、学校和新闻机构。涵盖申请、请示、报告、通知、通告、意见、决定、决议、议案、公报、命令、函、复函、批复、说明、方案、纪要、公告、公示、通报、制度、规定、办法、细则、操作规程、工作要点、总结、调研、讲话、致辞、主持词、述职、可研、审查材料、技术需求、新闻消息、编者按、新闻评论，以及采购、整改、反馈和 AI 算力等场景。

source
View on ClawHub

Often paired with

Keep exploring AgentHub

Most people compare similar tools or check scenario guides before installing—start here.

Browse more like thisSearch similarPick by scenarioPrompt playbooksSkill hands-onReviews & comparisons

Listing badge: put AgentHub on your site

Copy either snippet into your project homepage, docs, or GitHub README. The badge is a hotlinked SVG — nothing to host — and it links back to this page so visitors can find the install steps.

PreviewListed on AgentHub: character-refs
HTML
<a href="https://myagenthub.cn/p/io.github.eternityspring/shuohao-skills/character-refs" title="Listed on AgentHub: character-refs" target="_blank" rel="noopener">
  <img src="https://myagenthub.cn/badge/io.github.eternityspring/shuohao-skills/character-refs?lang=en" alt="Listed on AgentHub: character-refs" height="20" style="border:0"/>
</a>
Markdown (GitHub README)
[![Listed on AgentHub: character-refs](https://myagenthub.cn/badge/io.github.eternityspring/shuohao-skills/character-refs?lang=en)](https://myagenthub.cn/p/io.github.eternityspring/shuohao-skills/character-refs)

Badges are generated on the fly from /badge/<package-id>, so name and listing changes propagate automatically. Keep the link target unchanged — it is what counts as the referral.

Unified Manifest

{
  "id": "io.github.eternityspring/shuohao-skills/character-refs",
  "type": "skill",
  "version": "0.0.0",
  "displayName": "character-refs",
  "description": "给任何故事里的角色真出参考图（小说改编、自己原创的故事、单独设计一个角色都行，不需要小说原文）： 一段话描述角色，拆成分层字段、补全后确认， 先出一张正面全身锚点，其余视图（大头照、90° 侧面、背面、细节、45° 大头照）都只参考这张锚点， 按需分档出图。每张图带标识、可单独重出，重出后自动标出哪些图过期。 支持 Qwen Image（ComfyUI）、codex 内置出图、OpenAI Images API（GPT Image 2）和自定义命令，主图与派生图可以使用不同模型。 产出 asset.json + 一组 PNG + 双击就能开的报告。零依赖。 只要提示词、不出图的话使用 novel-characters。 Use when asked to 出角色图、做角色参考图、给我的角色出图、定妆照、真出三视图、character reference images。",
  "author": {
    "name": "eternityspring",
    "url": "https://github.com/eternityspring"
  },
  "repository": {
    "url": "https://github.com/eternityspring/shuohao-skills",
    "source": "github",
    "subfolder": "skills/character-refs"
  },
  "homepage": "https://github.com/eternityspring/shuohao-skills/tree/main/skills/character-refs",
  "distribution": {
    "packages": [
      {
        "registryType": "source",
        "identifier": "eternityspring/shuohao-skills@character-refs",
        "version": "main",
        "runtimeHint": "npx skills add"
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "codex",
    "vscode"
  ],
  "keywords": [],
  "provenance": {
    "origin": "github-cn",
    "originalId": "eternityspring/shuohao-skills/character-refs",
    "originalUrl": "https://github.com/eternityspring/shuohao-skills/tree/main/skills/character-refs",
    "isOfficial": false,
    "status": "active"
  }
}
character-refs Skill Install & Guide - AgentHub