Nima Skill Creator

Hybrid skill creation framework combining interactive Chinese-guided workflows with English technical documentation. Use when users want to create, update, o...

Security Scan

The skill's files, runtime instructions, and requested resources are consistent with a skill-creator framework and do not ask for unrelated credentials, installs, or suspicious behavior.

Purpose & Capability

Name/description (skill-creator) align with contents: SKILL.md, scripts/, references/, and assets/ provide guidance, templates, and helper scripts appropriate for creating new skills.

Instruction Scope

SKILL.md instructs the agent to present interactive discovery questions and to execute local scripts (init/validate/package). This is coherent for a skill-authoring tool, but note that executing scripts will perform filesystem actions (project creation, validation, packaging)—review/permission should be given before running them. The instructions do not reference external credentials, system config paths, or unexpected network endpoints.

Install Mechanism

No install spec is present (instruction-only plus local helper scripts included). No downloads, external package installs, or archive extraction are requested.

Credentials

The skill requires no environment variables, binaries, or credentials; requested resources (scripts, references, assets) are consistent with the stated purpose.

Persistence & Privilege

Skill is not marked always:true and allows normal autonomous invocation. It does request running its own local scripts but does not attempt to modify other skills or global agent settings.

Assessment

This package appears internally consistent for creating and packaging skills. Before enabling autonomous invocation or running the included scripts, review the scripts' implementation (they are small helper scripts in this bundle) and confirm you trust the source. If you plan to allow the agent to run the init/validate/package scripts automatically, consider limiting that to an explicit user action or running them in a sandbox/project directory so file creation is under your control. If you want higher assurance, provide the full executed script bodies or run them in an isolated environment to confirm there are no unexpected filesystem or network operations.

Overview

A professional skill creation framework that bridges the gap between user需求 discovery and technical implementation.

Core Features

1. 双语引导 (Dual-Language Guidance)

• 交互阶段: 中文引导用户需求挖掘
• 技术阶段: 英文标准文档和最佳实践

2. 渐进式披露 (Progressive Disclosure)

Level 1: Trigger metadata (name + description)
  ↓ (on trigger)
Level 2: SKILL.md body (<5k words)
  ↓ (on demand)
Level 3: Bundled resources (unlimited)

Workflow

阶段 1: 需求挖掘 (Discovery)

用户输入 → 交互式提问 → 技术规范输出

关键问题:

• Claude 应该输入什么？
• Claude 应该输出什么？
• 用户会怎么说来触发 Skill？

阶段 2: 架构蓝图 (Blueprint)

规范 → 目录结构 → 资源规划

输出:

• 目录结构 (scripts/, references/, assets/)
• 资源清单
• 工作流逻辑

阶段 3: 实现 (Implementation)

蓝图 → 代码/文档 → 验证 → 打包

技术标准 (Technical Specifications)

目录结构

skill-name/
├── SKILL.md              # Required (frontmatter + body)
├── scripts/              # Optional (executable code)
├── references/           # Optional (loaded on demand)
└── assets/               # Optional (output resources)

SKILL.md 格式

---
name: skill-name-here         # lowercase-hyphen-case, <64 chars
description: <1024 chars>     # Trigger scenarios + functionality
---

命名规范

• ✅ processing-pdfs, analyzing-spreadsheets
• ❌ helper, utils, tools

Here are 3 example Skill usage scenarios:

Scenario 1: PDF Processing Skill

Trigger: "Help me extract text and tables from PDFs" Workflow:

1. Discover: Input (PDF files), Output (extracted text/tables)
2. Blueprint: scripts/extract_pdf.py, references/pdf-libraries.md
3. Implement: Create script + reference docs

Scenario 2: Image Editor Skill

Trigger: "Edit images for my presentations" Workflow:

1. Discover: Input (image files), Output (edited images)
2. Blueprint: scripts/edit_image.py, assets/templates/
3. Implement: Create editing script + templates

Scenario 3: API Integration Skill

Trigger: "Connect Claude to my Notion workspace" Workflow:

1. Discover: Input (Notion API data), Output (structured results)
2. Blueprint: scripts/notion_api.py, references/notion-schema.md
3. Implement: Create API client + schema docs

Best Practices

简洁至上 (Conciseness)

• Claude 已经很聪明 → only add non-obvious context
• 每个 token 都要问: "Does Claude really need this?"

自由度匹配 (Freedom Matching)

Freedom Level	Use Case	Example
High	Multiple valid approaches	Code review workflow
Medium	Preferred pattern, some variation	Configurable scripts
Low	Fragile operations, consistency critical	Database migrations

渐进式披露 (Progressive Disclosure)

• SKILL.md body: <500 lines, essentials only
• Detailed content: references/ files
• No deeply nested references: one level deep only
• Long files: include table of contents

Validation Rules

Required

• ✅ SKILL.md exists with valid YAML frontmatter
• ✅ name: lowercase-hyphen-case, <64 characters
• ✅ description: includes functionality + trigger scenarios

Recommended

• 📝 scripts/ for executable code
• 📚 references/ for detailed documentation
• 🎨 assets/ for reusable templates

Avoid

• ❌ README.md, INSTALLATION_GUIDE.md, etc.
• ❌ Deeply nested references
• ❌ Duplicate information across files

For Implementation

See references/ for detailed technical guides:

• best-practices.md - Naming, patterns, quality checklist
• workflows.md - Multi-step process templates
• output-patterns.md - Output format templates
• interaction-guide.md - Interactive design patterns (Chinese)

For Agents

When this skill is triggered, the AI should:

1. Present the interactive discovery questions (Chinese) - see references/interaction-guide.md
2. Generate the technical blueprint (English)
3. Execute initialization scripts from scripts/
4. Guide implementation with referenced best practices
5. Validate with scripts/validate_skill.py
6. Package with scripts/package_skill.py