docs: comprehensive Skills and Claude integration documentation#49
Merged
Conversation
danielmeppiel
commented
Dec 8, 2025
danielmeppiel
commented
Collaborator
- Add Dependency Types table with Claude Skills to dependencies.md
- Add SKILL.md to project structure in getting-started.md
- Add Claude Skills install type to cli-reference.md
- Update Universal Compatibility for Claude target in concepts.md
- Add SKILL.md to primitives.md project structure
- Add Quick Start section to skills.md
- Add Dependency Types table with Claude Skills to dependencies.md - Add SKILL.md to project structure in getting-started.md - Add Claude Skills install type to cli-reference.md - Update Universal Compatibility for Claude target in concepts.md - Add SKILL.md to primitives.md project structure - Add Quick Start section to skills.md
Contributor
There was a problem hiding this comment.
Pull request overview
This PR comprehensively documents the Claude Skills integration feature, establishing SKILL.md as a fourth primitive type alongside agents, instructions, and context. The changes ensure consistent documentation across all user-facing materials and add automatic SKILL.md creation during project initialization.
Key Changes:
- Adds automatic SKILL.md creation in
apm initcommand with template content - Documents SKILL.md as a dependency type with transformation capabilities for different targets
- Adds Quick Start section to skills.md showing the new
apm initworkflow - Updates all documentation to reflect SKILL.md in project structure diagrams
Reviewed changes
Copilot reviewed 9 out of 9 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| templates/hello-world/SKILL.md | New template file for SKILL.md with placeholder variables and example content structure |
| src/apm_cli/cli.py | Implements SKILL.md creation in init command, updates file listing display with 📖 emoji |
| docs/skills.md | Adds Quick Start section documenting automatic SKILL.md creation by apm init |
| docs/primitives.md | Updates project structure to include SKILL.md, reorders primitive type list |
| docs/getting-started.md | Adds SKILL.md to project structure diagram in initialization section |
| docs/dependencies.md | Adds comprehensive Dependency Types table with Claude Skills section and examples |
| docs/concepts.md | Updates Universal Compatibility section with VSCode/Claude target distinctions |
| docs/cli-reference.md | Documents Claude Skills install type with transformation behavior |
| README.md | Updates package structure example to show SKILL.md as part of init output |
- Tagline: 'prompts, agents, and rules' (recognizable terms) - Quick Start: show package tree with prompt → slash command mapping - Community table: 'What you get' with actual /commands
Addresses PR review feedback: - Test SKILL.md is created during init - Test SKILL.md contains expected frontmatter structure - Test SKILL.md reflects project name and description - Test SKILL.md has expected sections (What This Package Does, etc.) - Test interactive mode creates SKILL.md with user-provided values
sergio-sisternes-epam
pushed a commit
that referenced
this pull request
May 19, 2026
docs: comprehensive Skills and Claude integration documentation
danielmeppiel
added a commit
that referenced
this pull request
Jun 25, 2026
…ion)
Add Job Set D to verify-shared-apm-matrix.yml: a cross-repo drift guard
that proves the `apm pack --archive` default archive format (.zip, source
of truth in src/apm_cli/bundle/packer.py) stays inside the extension set
the pinned microsoft/apm-action release detects when it scans the build
dir for a bundle.
This is the regression trap for the GH-AW Compatibility outage where the
CLI default flipped from .tar.gz to .zip while apm-action's bundler still
detected only '.tar.gz', so the job failed with 'apm pack produced no
bundle'. The guard reads apm-action's archive-detection set from
src/bundler.ts at the ref shared/apm.md pins and fails if the producer
default is not in it. Extraction is shape-tolerant: it reads the
ARCHIVE_EXTENSIONS constant (current apm-action contract) and falls back
to the older inline `entries.filter(... endsWith('.x'))` form.
Also adds src/apm_cli/bundle/packer.py to the workflow path triggers so a
future producer-default flip actually runs the trap.
NOTE: intentionally RED at the current pin (apm-action v1.7.2 detects only
.tar.gz). The consumer fix landed on apm-action main via
microsoft/apm-action#47 (#49 was closed as redundant) but is not yet in a
release tag. This trap flips green once apm-action cuts a tag containing
#47 AND the pin in shared/apm.md is bumped to it. Hold this PR until then.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.