### Reproducible setup Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Setup is now fully reproducible: `git clone` + `skillfile install` gives byte-identical results. ```bash git clone skillfile install ``` -------------------------------- ### Quick Start: Initialize and add skills Source: https://github.com/eljulians/skillfile/blob/master/README.md Demonstrates the basic commands to initialize skillfile and add skills, including a guided wizard and direct addition from GitHub. ```bash skillfile init # pick your platforms skillfile add # guided wizard skillfile add github skill anthropics/skills skills/ # or add directly ``` -------------------------------- ### Team Workflow Example Source: https://github.com/eljulians/skillfile/blob/master/README.md Example commands for adding local and community skills, committing changes, and a teammate installing them. ```bash # Write an in-house skill and track it vim skills/our-coding-standards/SKILL.md skillfile add local skill skills/our-coding-standards/SKILL.md # Pull in a community skill too skillfile add github skill anthropics/skills skills/slack-gif-creator # Commit everything git add Skillfile Skillfile.lock skills/ git commit -m "Add coding standards and research skills" git push ``` ```bash # Teammate clones and gets everything git pull skillfile install # deploys all skills to their platform ``` -------------------------------- ### Pre-commit Hooks Setup Source: https://github.com/eljulians/skillfile/blob/master/README.md Commands for installing and running pre-commit hooks for the skillfile project. ```bash pip install pre-commit # or: brew install pre-commit pre-commit install # install the git hook (once per clone) ``` ```bash pre-commit run --all-files ``` -------------------------------- ### Install skillfile using curl Source: https://github.com/eljulians/skillfile/blob/master/README.md Installs skillfile by downloading and executing an installation script from GitHub releases. ```bash curl -fsSL https://github.com/eljulians/skillfile/releases/latest/download/install.sh | sh ``` -------------------------------- ### Installing Skills Source: https://github.com/eljulians/skillfile/blob/master/README.md Commands for installing skills, including updating and previewing changes. ```bash skillfile install # fetch locked content skillfile install --update # update to latest upstream skillfile install --dry-run # preview without fetching skillfile status --check-upstream # see which entries have updates ``` -------------------------------- ### Skillfile install command Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Command to fetch and deploy in one step. ```bash skillfile install ``` -------------------------------- ### Skillfile Format Example Source: https://github.com/eljulians/skillfile/blob/master/README.md An example of the Skillfile format, showing platform targets, GitHub-hosted skills, local files, and direct URLs. ```plaintext # Platform targets install claude-code global install gemini-cli local # GitHub-hosted skills and agents github skill obra/superpowers skills/requesting-code-review github agent reviewer owner/repo agents/reviewer.md v2.0 github skill nuxt/ui@v4 skills/nuxt-ui # Local files local skill skills/git/commit.md # Direct URLs url agent my-agent https://example.com/agent.md ``` -------------------------------- ### Install skillfile using cargo Source: https://github.com/eljulians/skillfile/blob/master/README.md Installs skillfile using the cargo package manager. ```bash cargo install skillfile ``` -------------------------------- ### Cargo install with binstall Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Command to install Skillfile using cargo-binstall for faster installation. ```bash cargo binstall skillfile ``` -------------------------------- ### One-line installer Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md The command to install Skillfile using a curl script, with support for version and installation directory overrides. ```bash curl -fsSL .../install.sh | sh ``` -------------------------------- ### Install with update flag Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md The `install --update` flag automatically captures local edits before re-fetching upstream. ```bash install --update ``` -------------------------------- ### Lock File JSON Example Source: https://github.com/eljulians/skillfile/blob/master/SPEC.md Provides an example of the Skillfile.lock JSON format, showing how GitHub, local, and URL entries are represented. ```json { "github/agent/code-refactorer": { "owner_repo": "owner/repo", "path": "agents/code-refactorer.md", "ref": "main", "sha": "abc123def456..." }, "local/skill/commit": { "path": "skills/git/commit.md" }, "url/skill/browser": { "url": "https://example.com/browser-skill.md" } } ``` -------------------------------- ### Install Lines Format Source: https://github.com/eljulians/skillfile/blob/master/SPEC.md Defines the format for 'install' lines in a Skillfile, specifying the platform and scope for deployment targets. ```plaintext install ``` -------------------------------- ### Customize and pin skills Source: https://github.com/eljulians/skillfile/blob/master/README.md Illustrates how to edit an installed skill, pin the changes to preserve them during updates, and then update the skill while reapplying the patch. ```bash vim ~/.claude/skills/browser/SKILL.md # edit the deployed file skillfile pin browser # capture your diff as a patch skillfile install --update # update upstream, patch reapplied ``` -------------------------------- ### Quoting Example Source: https://github.com/eljulians/skillfile/blob/master/SPEC.md Illustrates POSIX shell quoting rules for fields in Skillfile, showing how spaces and special characters are preserved within quoted strings. ```plaintext local skill "my skills/git commit.md" ``` -------------------------------- ### Inline Comments Example Source: https://github.com/eljulians/skillfile/blob/master/SPEC.md Demonstrates how inline comments are handled in Skillfile, showing that text after a '#' preceded by whitespace is ignored. ```plaintext github skill owner/repo path.md # this is stripped ``` -------------------------------- ### Fish Shell Completion Source: https://github.com/eljulians/skillfile/blob/master/README.md Command to generate and install fish shell completions for skillfile. ```bash skillfile completions fish > ~/.config/fish/completions/skillfile.fish ``` -------------------------------- ### Search community registries Source: https://github.com/eljulians/skillfile/blob/master/README.md Provides examples of searching for skills in community registries using the skillfile CLI, including interactive search, filtering by trust score, and targeting specific registries. ```bash skillfile search "code review" # interactive TUI with preview skillfile search docker --min-score 80 # only high-trust results skillfile search testing --registry agentskill.sh # target a single registry ``` -------------------------------- ### Skillfile pin command Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Command to capture edits to an installed upstream entry. ```bash skillfile pin ``` -------------------------------- ### Skillfile init command Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md The `skillfile init` command now automatically adds correct .gitignore entries. ```bash skillfile init ``` -------------------------------- ### Add local and URL skills Source: https://github.com/eljulians/skillfile/blob/master/README.md Demonstrates how to add skills from a local file path or a URL. ```bash skillfile add local skill skills/my-custom/SKILL.md # track a local file skillfile add url skill https://example.com/skill.md # add from a URL ``` -------------------------------- ### Zsh Shell Completion (Script) Source: https://github.com/eljulians/skillfile/blob/master/README.md Instructions for setting up zsh shell completions by sourcing a generated script. ```zsh skillfile completions zsh > ~/.zfunc/_skillfile # add this before `compinit` in ~/.zshrc: fpath=(~/.zfunc $fpath) autoload -Uz compinit compinit ``` -------------------------------- ### Add skills from GitHub Source: https://github.com/eljulians/skillfile/blob/master/README.md Shows various ways to add skills from GitHub, including discovering all skills in a repo, adding a specific skill, and adding from a specific branch or tag. ```bash skillfile add # wizard: GitHub, search, local, URL skillfile add github skill anthropics/skills # discover all skills in a repo skillfile add github skill anthropics/skills slack-gif-creator # add one specific skill skillfile add github skill nuxt/ui@v4 skills/ # add from a specific branch or tag ``` -------------------------------- ### Skillfile sync command Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Command to fetch community entries and write .meta files. ```bash skillfile sync ``` -------------------------------- ### GitHub source fetching Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md GitHub source fetches from `raw.githubusercontent.com`, eliminating the need for cloning. ```bash raw.githubusercontent.com ``` -------------------------------- ### Source types Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Supported source types for Skillfile entries. ```bash github ``` ```bash local ``` ```bash url ``` -------------------------------- ### Development Tests Source: https://github.com/eljulians/skillfile/blob/master/README.md Commands for running tests, linting, and formatting checks in the skillfile project. ```bash cargo test --workspace cargo test --test upstream cargo clippy --all-targets -- -D warnings cargo fmt --check ``` -------------------------------- ### Shell Completions Source: https://github.com/eljulians/skillfile/blob/master/README.md Commands to generate shell completions for Bash and Zsh. ```bash # Bash skillfile completions bash > ~/.local/share/bash-completion/completions/skillfile # Zsh # add this after your existing `compinit` in ~/.zshrc echo 'source <(skillfile completions zsh)' >> ~/.zshrc ``` -------------------------------- ### Skillfile format command Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Command to format and sort the Skillfile. ```bash skillfile format ``` -------------------------------- ### Entity types Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Supported entity types in Skillfile. ```bash skill ``` ```bash agent ``` -------------------------------- ### Skillfile manifest format Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md The `Skillfile` manifest format is line-oriented, space-delimited, and human-editable. ```bash Skillfile ``` -------------------------------- ### Skillfile Cache Structure Source: https://github.com/eljulians/skillfile/blob/master/SPEC.md Shows the directory structure for the skillfile cache, including fetched files and .meta files with source metadata. ```bash .skillfile/cache/ skills/ browser/ SKILL.md .meta agents/ code-refactorer/ code-refactorer.md .meta ``` -------------------------------- ### Zsh Stale Completion Fix Source: https://github.com/eljulians/skillfile/blob/master/README.md Command to run if zsh still serves stale completions after switching methods. ```zsh rm -f ~/.zcompdump && compinit ``` -------------------------------- ### Sync command Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md The `sync` command skips entries whose SHA already matches the lock. ```bash sync ``` -------------------------------- ### Shell completions generation Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Commands to generate static shell completion scripts and dynamic completions for various shells. ```bash skillfile completions ``` ```bash eval "$(COMPLETE=bash skillfile)" ``` -------------------------------- ### Skillfile status command Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Command to show which entries are locked, unlocked, or outdated. ```bash skillfile status ``` -------------------------------- ### Skillfile add command Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Command to add an entry to the Skillfile without manual editing. ```bash skillfile add ``` -------------------------------- ### Skillfile validate command Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Command to check the Skillfile for syntax errors, unknown platforms, and duplicate names. ```bash skillfile validate ``` -------------------------------- ### Skillfile Patches Structure Source: https://github.com/eljulians/skillfile/blob/master/SPEC.md Illustrates the directory structure for skill patches, including single-file entries and directory entries for language specialists. ```bash .skillfile/patches/ skills/ browser.patch # single-file entry patch language-specialists/ # directory entry: one patch per file python.md.patch typescript.md.patch agents/ code-refactorer.patch ``` -------------------------------- ### GitHub Entry Format Source: https://github.com/eljulians/skillfile/blob/master/SPEC.md Defines the format for 'github' entry lines in a Skillfile, used to declare skills or agents from GitHub repositories. ```plaintext github [name] [ref] ``` -------------------------------- ### Skillfile unpin command Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Command to discard customisations and revert to pure upstream. ```bash skillfile unpin ``` -------------------------------- ### Skillfile diff command Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Command to show upstream changes after a conflict. ```bash skillfile diff ``` -------------------------------- ### Skillfile lock file Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md The `Skillfile.lock` records the exact commit SHA for every upstream entry. ```bash Skillfile.lock ``` -------------------------------- ### URL Entry Format Source: https://github.com/eljulians/skillfile/blob/master/SPEC.md Specifies the format for 'url' entry lines in a Skillfile, used to declare skills or agents from direct URLs. ```plaintext url [name] ``` -------------------------------- ### Resolving Upstream Conflicts Source: https://github.com/eljulians/skillfile/blob/master/README.md Commands to view and resolve conflicts when upstream changes affect local modifications. ```bash skillfile diff browser # see what changed skillfile resolve browser # three-way merge in $MERGETOOL ``` -------------------------------- ### Skillfile resolve command Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Command to perform a three-way merge of customisations with upstream changes. ```bash skillfile resolve ``` -------------------------------- ### Local Entry Format Source: https://github.com/eljulians/skillfile/blob/master/SPEC.md Specifies the format for 'local' entry lines in a Skillfile, used to declare local skills or agents. ```plaintext local [name] ``` -------------------------------- ### Copy flag Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md The `--copy` flag copies files instead of symlinking (default since v0.5.0). ```bash --copy ``` -------------------------------- ### Skillfile remove command Source: https://github.com/eljulians/skillfile/blob/master/CHANGELOG.md Command to remove an entry and clear its cache. ```bash skillfile remove ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.