Skip to content

docs: Add documentation for the --as-skill flag (kit unpack)#1173

Open
Copilot wants to merge 2 commits intomainfrom
copilot/update-documentation-for-as-skill-flag
Open

docs: Add documentation for the --as-skill flag (kit unpack)#1173
Copilot wants to merge 2 commits intomainfrom
copilot/update-documentation-for-as-skill-flag

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 30, 2026

Documents the --as-skill flag introduced in #1158, which installs SKILL.md prompt layers from a ModelKit directly into supported coding agents' config directories.

The cli-reference.md was already auto-generated with the new flag. The gaps were in the user-facing guides.

Changes

  • docs/src/docs/next-steps.md — Added "Installing Agent Skills" subsection under "The Power of Unpack" covering:

    • --as-skill (no value): auto-discovers agents by probing global config dirs
    • --as-skill=claude-code,cursor,windsurf: targets specific agents
    • Global (default) vs. project-scoped install via -d
    • -o to overwrite existing skills
    • Tip callout explaining the SKILL.md requirement and skill name derivation
  • docs/src/docs/use-cases.md — Updated the agentic AI "In Practice" workflow to mention kit unpack --as-skill as the mechanism for distributing skill files to agent config directories.

Linked issues

AI-Assisted Code

  • This PR contains AI-generated code that I have reviewed and tested
  • I take full responsibility for all code in this PR, regardless of how it was created

Copilot AI linked an issue Apr 30, 2026 that may be closed by this pull request
Documents the new --as-skill flag introduced in PR #1158:
- Adds "Installing Agent Skills" subsection in next-steps.md
  under "The Power of Unpack"
- Mentions --as-skill in use-cases.md agentic AI workflow

Agent-Logs-Url: https://github.com/kitops-ml/kitops/sessions/3694b08c-2d2a-4e06-9f11-a41ce143efad

Co-authored-by: gorkem <82738+gorkem@users.noreply.github.com>
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Apr 30, 2026

Deploying kitops-org with  Cloudflare Pages  Cloudflare Pages

Latest commit: b6ddb2c
Status: ✅  Deploy successful!
Preview URL: https://e53f81ea.kitops-org.pages.dev
Branch Preview URL: https://copilot-update-documentation-e8f0.kitops-org.pages.dev

View logs

Copilot AI changed the title [WIP] Add documentation for the --as-skill flag docs: Add documentation for the --as-skill flag (kit unpack) Apr 30, 2026
Copilot AI requested a review from gorkem April 30, 2026 17:15
@gorkem gorkem requested a review from bmicklea May 5, 2026 21:42
@gorkem gorkem marked this pull request as ready for review May 5, 2026 21:42
Copy link
Copy Markdown
Collaborator

@bmicklea bmicklea left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Documentation for the --as-skill flag

3 participants