Sn Image Doctor Agent Skill
| Environment diagnostic skill for SenseNova-Skills project. Checks that sn-image-base is properly installed and configured, validates dependencies and environment variables. Prompts user to configure missing required variables and saves them to .env file. After configuration, reloads environment and suggests agent restart if needed.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/OpenSenseNova/SenseNova-Skills --skill sn-image-doctorThe instruction itself
15 sections, as written by the authorsn-image-doctor
Overview
sn-image-doctor is an infrastructure skill (tier 0) that validates the SenseNova-Skills environment before running other skills. It ensures SenseNova-Skills project is properly installed and configured.
This skill performs comprehensive checks including:
- Installation verification of SenseNova-Skills project
- Python dependency validation
- Environment variable configuration checks, with interactive prompts to configure missing required variables and save them to
.env - Automatic environment reload after configuration changes, with agent restart suggestion if reload fails
Usage
Run the doctor check to validate your environment:
# Basic check
python scripts/check_environment.py
# Verbose output with detailed diagnostics
python scripts/check_environment.py --verbose
Output Format
Text Output
=== SenseNova-Skills Environment Check ===
[1/3] Checking sn-image-base installation...
✅ Installation looks good
[2/3] Checking Python dependencies...
✅ Python 3.11.0
✅ All required packages installed
[3/3] Checking environment variables...
❌ SN_IMAGE_GEN_API_KEY: Image generation API key is not set; configure SN_API_KEY, or configure SN_IMAGE_GEN_API_KEY only for an image-generation-specific override
Some required environment variables are missing.
Enter values below to save them to /path/to/.env.
Press Enter to skip a variable.
SN_API_KEY: <user input>
✅ Saved to /path/to/.env: SN_API_KEY
🔄 Reloading environment...
✅ Environment reloaded successfully
=== Summary ===
✅ Environment is properly configured
If reload fails, the output will suggest restarting the agent:
✅ Saved to /path/to/.env: SN_API_KEY
🔄 Reloading environment...
⚠️ Failed to reload environment: <error message>
💡 Suggestion: Restart the agent to apply new configuration
Error Output
When checks fail:
=== SenseNova-Skills Environment Check ===
[1/3] Checking sn-image-base installation...
❌ sn-image-base directory not found
Expected location: /path/to/skills/sn-image-base
[2/3] Checking Python dependencies...
❌ Missing packages: httpx, pillow
Run: pip install -r skills/sn-image-base/requirements.txt
=== Summary ===
❌ Environment check failed
Please fix the errors above before using SenseNova-Skills.
Troubleshooting
sn-image-base Not Found
Problem: sn-image-base directory not found
Solution:
# Ensure you're in the project root
cd /path/to/SenseNova-Skills
# Verify the directory exists
ls -la skills/sn-image-base
Missing Dependencies
Problem: Required Python packages not installed
Solution:
# Install dependencies
pip install -r skills/sn-image-base/requirements.txt
# Or use a virtual environment
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
pip install -r skills/sn-image-base/requirements.txt
Missing Environment Variables
Problem: Required environment variables not set
Solution:
# If all capabilities use the same gateway, set only the global values.
export SN_API_KEY="your-api-key"
export SN_BASE_URL="https://your-api-endpoint.com"
# Or create a .env file
cat > .env << EOF
SN_API_KEY=your-api-key
SN_BASE_URL=https://token.sensenova.cn/v1
SN_CHAT_TYPE=openai-completions
SN_CHAT_MODEL=sensenova-6.7-flash-lite
EOF
# Load .env file
source .env # Or use a tool like python-dotenv
Fallback priority is capability-specific variable > domain shared variable > global variable. For example, text calls use SN_TEXT_API_KEY -> SN_CHAT_API_KEY -> SN_API_KEY; vision calls use SN_VISION_API_KEY -> SN_CHAT_API_KEY -> SN_API_KEY; image generation uses SN_IMAGE_GEN_API_KEY -> SN_API_KEY.
API Connectivity Issues
Problem: Cannot reach API endpoints
Solution:
- Verify network connectivity
- Check firewall settings
- Verify API endpoint URLs are correct
- Test with curl:
curl -I https://your-api-endpoint.com
Integration with Other Skills
This skill is designed to be run before using other skills in the SenseNova-Skills project:
# 1. Run doctor check
python skills/sn-image-doctor/scripts/check_environment.py
# 2. If checks pass, use other skills
python skills/sn-image-base/scripts/sn_agent_runner.py sn-image-generate \
--prompt "A beautiful landscape"
Command-Line Options
| Option | Description |
|--------|-------------|
| --verbose | Show detailed diagnostic information |
| --help | Show help message |
Exit Codes
| Code | Meaning |
|------|---------|
| 0 | All checks passed |
| 1 | One or more checks failed |
See Also
sn-image-base/SKILL.md- Base-layer skill documentationsn-image-base/references/api_spec.md- API specificationsn-infographic/SKILL.md- Example of a skill that depends on sn-image-base
Other skills for the same job
different authors, same section of the catalogue
agent-im 会话技能 - 通过 liblib.tv 的 AI 能力生成和编辑图片/视频。覆盖场景包括：生成（文生图、文生视频、图生视频、做动画、画一个xxx、来段xxx）、编辑修改（把xxx换成yyy、去掉xxx、加上xxx、改成xxx、调整xxx、局部修改、改镜头）、风格转换（风格迁移、转绘、换风格）、视频续写延长、复刻视频/TVC/宣传片、短剧/短漫剧生成、音乐MV生成、产品广告/展示片制作、分镜/故事板设计、教育视频/短视频制作。当用户提到 liblib、libtv、上传参考图/视频、查看生成进度时也应触发。关键判断：只要用户的请求涉及 AI 图片或视频的创作、生成、编辑、修改，无论措辞如何（如"画只猫"、"做个海报"、"把纸船换成爱心"、"这个视频帮我改一下"、"帮我复刻这段视频"、"用这首歌做个MV"、"一句话生成短剧"），都必须触发此技能。
This skill should be used when the user asks to "generate video prompts", "create Seedance prompts", "write video descriptions", mentions "Seedance", "seedance", "即梦", "即梦平台", "视频提示词", "视频生成", "AI视频", "短剧", "广告视频", "视频延长", or discusses video prompt engineering, AI video generation, or Seedance 2.0 workflows.
Best practices and techniques for writing effective AI video generation prompts. Covers: Veo, Seedance, Wan, Grok, Kling, Runway, Pika, Sora prompting strategies. Learn: shot types, camera movements, lighting, pacing, style keywords, negative prompts. Use for: improving video quality, getting consistent results, professional video prompts. Triggers: video prompt, how to prompt video, veo prompts, video generation tips, better ai video, video prompt engineering, video prompt guide, video prompt template, ai video tips, video prompt best practices, video prompt examples, cinematography prompts
This skill is a practical, 'use-it-while-debugging' reference for getting a LiveKit + Letta voice agent working reliably.
Download screenshot baselines from the latest CI run and commit them. Use when asked to update, accept, or refresh component screenshot baselines from CI, or after the screenshot-test GitHub Action reports differences. This skill should be run as a subagent.
| Turn vague taste, screenshots, URLs, product notes, or "make it feel like this" references into a grounded DESIGN.md plus an implementation handoff. Use it before prototypes, decks, redesigns, or image remix work when the user needs a reusable visual direction rather than a one-off prompt.
>- Upload local assets (images, mockups, extracted HTML, design markdown) to a Stitch project. ALWAYS use this skill when you need to upload visual assets, HTML pages, or design docs to Stitch, particularly when direct MCP tool calls fail or truncate due to base64 token limits.
This skill helps users automatically extract channel-level and video detail data from a specific YouTube channel via BrowserAct API. Agent should proactively apply this skill when users express needs like extracting channel video data, getting latest or popular videos from a YouTube channel, tracking competitor channel content, extracting video metrics such as views likes comments, retrieving subscriber count and channel info, monitoring posting cadence of a YouTube channel, gathering video data for content strategy analysis, getting earliest videos of a YouTube creator, analyzing engagement signals across a full channel, and downloading structured YouTube video details without manual scraping.
How to use it
Take opensensenova/sn-image-doctor from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference pip.
Without those the skill loads but fails at the first command.