Dokümantasyon, testler, değerlendirmeler ve küçük resim sanatını içeren eksiksiz ve taşınabilir agent skill'lerini yönetilen bir depoda oluşturur ve kaydeder.
- GitHub yıldızları
- 18
- Dosyalar
- 23
- Son commit
- 12 Kas 2026
- Lisans
- MIT
- İzin verilen araçlar
- —
create-skill skill ne işe yarar?
Dokümantasyon, testler, değerlendirmeler ve küçük resim sanatını içeren eksiksiz ve taşınabilir agent skill'lerini yönetilen bir depoda oluşturur ve kaydeder.
Özet, skill'in SKILL.md dosyasından oluşturuldu.
create-skill skilli hakkında
Standartlaştırılmış agent yetenekleri oluşturmak ve dağıtmak isteyen geliştiriciler, bu aracı yönetilen bir depo içinde eksiksiz ve taşınabilir skill'ler iskeleti oluşturmak ve kaydetmek için kullanabilirler. SKILL.md, README.md, lisans dosyaları ve paket yapılandırmaları dahil olmak üzere temel dosyaların oluşturulmasını otomatize ederken, aynı zamanda deterministik testler ve Vally değerlendirmeleri üretir. İş akışı, her yeni skill'in marketplace, plugin veya katalog gibi mevcut kayıt yüzeylerine düzgün bir şekilde entegre edilmesini sağlar.
Bir agent bir depoya yeni bir yetenek eklemesi gerektiğinde, tüm dosya yapısını ve kayıt sürecini planlamak için bu skill'i yükler. Keşif için bir skills-repo.config.json dosyasına güvenir ve kazara yazma işlemlerini önlemek için katı bir dry-run ve onay mekanizması kullanır. Kodun ötesinde, Azure OpenAI GPT Image 2 veya OpenAI Images gibi sağlayıcılar veya özel teslimat iş akışları aracılığıyla küçük resim (thumbnail) oluşturma işlemlerini yönetir. Bu, her skill'in yalnızca işlevsel ve test edilmiş olmasını değil, aynı zamanda depo kataloğunda görsel olarak temsil edilmesini de sağlar.
Bir agent bununla neler yapabilir
- 1Yeni bir taşınabilir skill iskeleti oluşturunTek bir komutla gerekli tüm dokümantasyon, testler ve meta verileri içeren eksiksiz bir skill dizini oluşturun.
- 2Skill küçük resim sanatı oluşturunYapay zeka sağlayıcılarını veya özel iş akışlarını kullanarak mevcut bir skill için doğrulanmış küçük resimler üretin veya içeri aktarın.
- 3Mevcut bir skill'i kaydedinDaha önce yazılmış bir skill'i, yerel dosyalarını üzerine yazmadan deponun kayıt yüzeylerine ekleyin.
- 4JSON fixture'lardan skill'ler oluşturunSağlanan bir JSON girişinden doğrulanmış örnek skill'ler üretmek için etkileşimsiz (non-interactive) modu kullanın.
Skill'in SKILL.md dosyasından yazılmıştır. Her kullanım durumu oradaki bir alıntı ile kontrol edilir.
create-skill skill nasıl kurulur
Her komut, skill klasörünü istemcinin skills dizinine kopyalar. Yüklemek için istemciyi yeniden başlatın veya yeni bir oturum başlatın.create-skill skill'ini Eklenti uygulamasına kur
/plugin marketplace add jongio/skills /plugin install jongio-skills@jongio-skills
create-skill skill'ini Claude Code uygulamasına kur
~/.claude/skills/create-skill/SKILL.md
$ npx degit jongio/skills/skills/create-skill ~/.claude/skills/create-skillcreate-skill skill'ini Claude Code (project) uygulamasına kur
.claude/skills/create-skill/SKILL.md
$ npx degit jongio/skills/skills/create-skill .claude/skills/create-skillcreate-skill skill'ini Codex uygulamasına kur
~/.agents/skills/create-skill/SKILL.md
$ npx degit jongio/skills/skills/create-skill ~/.agents/skills/create-skillcreate-skill skill'ini Gemini CLI uygulamasına kur
~/.gemini/skills/create-skill/SKILL.md
$ npx degit jongio/skills/skills/create-skill ~/.gemini/skills/create-skillcreate-skill skill'ini Claude.ai uygulamasına kur
npx degit jongio/skills/skills/create-skill create-skill && zip -r create-skill.zip create-skill # claude.ai → Customize → Skills → + → Create skill → Upload a skill → create-skill.zip
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizi geçti. Bu bir güvenlik denetimi değil: bir ajanın çalıştırmasına izin vermeden önce betikleri okuyun. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirjongio/skills/skills/create-skill is public and reachablegithub.com/jongio/skills/tree/HEAD/skills/create-skill ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit 2026-11-12github.com/jongio/skills/commits ↗Geçti
- Betiklerde indir-çalıştır veya kimlik bilgisi hırsızlığı yok5 of 9 scripts read; none of them downloads and runs code, the rest were not readBulgu
- SKILL.md içinde gizli talimat yokNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/jongio/skills/blob/HEAD/skills/create-skill/SKILL ↗Geçti
- Önceden izin verilen araçlar sınırlıNo pre-approved tools; the agent asks before using onegithub.com/jongio/skills/blob/HEAD/skills/create-skill/SKILL ↗Geçti
- SKILL.md, Agent Skills biçimine uyuyorValid name and description; says when to use it; 230 linesgithub.com/jongio/skills/blob/HEAD/skills/create-skill/SKILL ↗Geçti
SKILL.md
GitHub'da görüntüle[!CAUTION] Read and follow the shared safety rules before any action. Preview local writes and obtain explicit approval. Git and GitHub writes require their own approval and are outside this skill.
Create Skill
Create one complete skill and register every repository surface without guessing. The workflow plans first, fails closed on ambiguous conventions, and applies one approved change set.
Commands
| Command | Purpose |
|---|---|
create-skill <name> |
Create and register a new skill with deterministic placeholder art. |
create-skill art <name> |
Preview and create or ingest thumbnail art for an existing skill. |
create-skill register <name> |
Preview and register an existing complete skill without replacing its authored files. |
create-skill check <name> |
Validate the skill shape and thumbnail parity without writing. |
create-skill fixture --input <json> --repo-root <path> |
Deterministically create a validated fixture skill without interview prompts. |
Every mutating command starts with --dry-run. Apply the unchanged plan only after the user
approves its single-use hash.
Workflow
1. Resolve the request
Collect only missing values:
- Skill name in lowercase-dash form.
- A one-sentence summary.
- Specific
USE FORphrases that users will type. - Specific
DO NOT USE FORboundaries and the sibling workflow that should win. - Copyright holder, when repository conventions do not identify one.
- Art choice: Azure OpenAI GPT Image 2, OpenAI Images, custom workflow, or placeholder.
Search installed and repository skills for overlapping triggers before creation. If another skill already owns the same job, stop and propose extending it.
2. Discover the repository
Run from the target repository, not this installed skill directory.
- Prefer the nearest
skills-repo.config.json. - Validate managed identity and settings before deriving canonical repository paths.
- Without managed config, discover the existing populated
skills/directory and known registration surfaces. - Stop before any write when multiple skill roots or catalog surfaces are plausible.
See repository discovery for the exact contract.
3. Preview creation
Invoke this script by absolute path while keeping the target repository as the working directory:
node <skill-dir>/scripts/create-skill.mjs <name> \
--summary "<summary>" \
--use-for "<trigger phrases>" \
--do-not-use-for "<boundaries>" \
--author "<holder>" \
--dry-run
Show the complete JSON preview and approval token. The preview includes every skill file and every registration surface. Ask the user to approve that exact hash once.
4. Apply creation
Repeat the same command and replace --dry-run with --approve <hash>. Do not alter any input
between preview and apply. The tool rejects a stale hash, existing skill directory, symlinked
destination, missing locked Vally toolchain, ambiguous registration, or invalid PNG.
Creation includes:
SKILL.mdwithname,description, andmetadata.versionfrontmatter.README.md,LICENSE,package.json, andpackage-lock.json..vally.yaml, deterministic tests, andevals/<name>/eval.yaml.thumbnail.pngas the tracked source for catalog synchronization when a catalog is present.- Marketplace, plugin, README, eval workflow, Dependabot, and catalog registration when present.
- Prompt and non-secret provenance in
docs/thumbnail-prompts.mdwhen present.
5. Choose art
The initial placeholder is deliberate and deterministic. Replace it only when requested.
Built-in providers
Preview the exact action:
node <skill-dir>/scripts/create-skill.mjs art <name> \
--provider azure-openai \
--prompt "<exact prompt>" \
--dry-run
Supported choices:
azure-openai: Azure OpenAI GPT Image 2 at the exact configuredhttps://<resource>.openai.azure.comorigin.openai: OpenAI Images at the exacthttps://api.openai.comorigin.placeholder: deterministic local PNG with no network or billed call.
The placeholder and check commands run on bare Node. Before a network provider, run
npm ci --ignore-scripts in the installed create-skill directory so its locked SDKs are
available.
Show provider, exact endpoint, model, prompt, targets, billing status, one attempt, and no fallback.
Ask for approval of the single-use action hash. Then repeat with --approve <hash>.
Built-in requests disable redirects and SDK retries. Never retry automatically. Never switch providers after a timeout, redirect, rate limit, service error, invalid response, or rejected PNG. Report the failure and ask the user what to do.
Custom provider or delivery workflow
Ask: "Describe any provider and delivery workflow you want me to use for the thumbnail."
The answer is open-ended. It may name an API, MCP tool, browser flow, local application, uploaded attachment, shared storage location, human handoff, or another delivery mechanism. Never reduce the choice to a local command.
Convert the answer into an exact action preview containing:
- Provider and destination.
- Exact prompt and non-secret data sent.
- Exact tool calls, API origin, browser actions, or human handoff steps.
- Billing or external side effects.
- One attempt and no fallback.
- How the final PNG will arrive in the target repository workspace.
- The skill and catalog paths that will receive the validated bytes.
Show that preview and obtain explicit single-use approval before taking the custom action. Execute only the approved steps once. Never place credentials in the preview or provenance.
After delivery, save the result as a repository-relative regular file and ingest it:
node <skill-dir>/scripts/create-skill.mjs art <name> \
--provider custom \
--custom-description "<approved provider and delivery steps>" \
--custom-provider "<provider name>" \
--custom-model "<model or method>" \
--delivery "<delivery method>" \
--input "<repository-relative PNG>" \
--dry-run
Approve the displayed hash, then repeat with --approve <hash>. The CLI never executes a custom
command. It accepts the delivered PNG only after the same strict validation used for built-in art.
See art and provenance.
6. Validate
Run:
node <skill-dir>/scripts/create-skill.mjs check <name>
npm test
npm run eval:lint
Run vally lint <skill-dir>, skill-doctor, and registration parity checks when available in
the target repository. Do not run the full capability eval unless the user accepts
its agent usage.
7. Generate a deterministic fixture
Repository generators may create functional example skills through the stable fixture contract:
node <skill-dir>/scripts/create-skill.mjs fixture \
--input "<fixture.json>" \
--repo-root "<target-repository>" \
--dry-run
Parse the JSON preview, obtain or propagate approval for its hash, then repeat the unchanged
command with --approve <hash>. Fixture mode is always noninteractive. It accepts only the version
1 schema, deterministic built-in placeholder art, and the normal repository registration path.
It never bypasses dry-run, approval, validation, atomic writes, or provenance.
Read fixture mode for the exact payload and exit contract.
Repository generators use create-skill register create-skill --dry-run, followed by the
unchanged command with --approve <hash>, after catalog staging. This registers the bundled
authoring skill through the same atomic path without rewriting its skill files.
Safety
- Dry-run never writes files or calls an image provider.
- Approval binds the exact inputs and target paths. Changed inputs require a new preview.
- Provider requests make one attempt with no retry, redirect, or fallback.
- Custom workflows require an exact preview and approval before any external action.
- Provider output is untrusted until the complete PNG validator accepts it.
- The validated skill thumbnail is the tracked source; catalog builds generate public copies.
- Secrets never enter prompts, previews, logs, generated files, or provenance.
- Existing files are preserved when planning fails. Apply uses staged sibling files and rollback.
- No git staging, commit, push, issue, pull request, or repository setting change is part of this skill.
Exit Criteria
-
New skills declare
metadata.versionas a quoted SemVer string. Preserve existing skill versions during registration; use the repository's version helper to bump a release and synchronize plugin listings when available. -
The skill has every required file and only portable SKILL.md frontmatter keys.
-
Every discovered or configured registration surface includes the skill.
-
The tracked skill thumbnail passes strict PNG validation; catalog builds generate the public copy.
-
Prompt and non-secret provenance are recorded when that repository surface exists.
-
Deterministic tests and Vally lint pass.
-
The final report lists exact changed files, commands, results, and any blocked work.
Bu becerideki dosyalar
23create-skill skill soruları
create-skill skill'ini Claude Code uygulamasına nasıl kurarım?
npx degit jongio/skills/skills/create-skill ~/.claude/skills/create-skill komutunu çalıştırın. Claude Code, skill'leri ~/.claude/skills (tüm projeler) veya .claude/skills (tek proje) konumundan yükler ve açıklaması görevle eşleştiğinde skill'i kullanır.
create-skill skill'ini hangi istemciler kullanabilir?
Agent Skills biçimini okuyan her istemci: Claude Code, Codex, Gemini CLI ve claude.ai (ZIP olarak yükleyin). Skill içindeki betikler yalnızca istemcinin kod çalıştırmaya izin verdiği yerlerde çalışır.
Bu skill, commit veya push gibi Git işlemlerini gerçekleştiriyor mu?
Hayır, bu skill herhangi bir git staging, commit, push veya diğer depo ayarlarını değiştirme işlemini gerçekleştirmez.