skill-importer

Files (3)

• SKILL.md
• impl.py
• skill.json

SKILL.md (first lines)

# Skill Purpose
Use this skill when a user provides a folder and wants it converted into a reusable Cowork skill.

## When to Use
Use it to inspect a source folder, summarize its capabilities, suggest which lightweight tools are relevant, and generate skill metadata after user confirmation.

Use Skill Center for user-facing imports. It can now accept either a source folder or a ZIP package; ZIP packages are unpacked safely and then routed through the same Cowork skill adaptation path.

## When Not to Use
Do not use it for simple one-off file edits or when the user only wants an explanation of the folder contents.

## Interface Details
`analyze_skill_source_folder` returns a JSON preview describing the inferred skill name, kind, candidate tool refs, references, risks, and generated metadata draft.

`generate_skill_from_folder` copies the source folder into `ai_skills/<name>` and writes `SKILL.md` plus `skill.json` centered on explanation, tool refs, and recommended workflow.

Skill Manager ZIP import supports flat-root packages and single-folder packages, reads the final skill name from `skill.json` or `SKILL.md`, rejects existing target names, and reloads skills after successful import.

## Constraints and Safety Rules
Always preview before writing. Do not overwrite an existing generated skill unless the user has confirmed the update path.

When importing ZIP packages, never trust archive paths directly. The current Skill Manager validates that extracted paths stay inside the temporary extraction directory before adapting the package.

## Common Pitfalls
Folders often contain multiple scripts and partial documentation. Prefer documenting the smallest useful tools instead of turning the entire folder into one big executable workflow.

## Experience / Lessons Learned
Keep the generated skill knowledge-first: document interfaces and caveats before introducing new executable wrappers.

From chuancyzhang/deepseek-cowork, Apache-2.0.

More from chuancyzhang/deepseek-cowork