@patimweb/pi-cap-bestpractices

SAP CAP (Cloud Application Programming Model) skills for the pi coding agent — ships the official SAP capire/skills (cap-developer, cap-add-remote-service, cap-trivia, cap-upgrade) as a git submodule.

Packages

Package details

skill

Install @patimweb/pi-cap-bestpractices from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@patimweb/pi-cap-bestpractices

Package: @patimweb/pi-cap-bestpractices
Version: 2.0.0
Published: Aug 25, 2026
Downloads: 269/mo · 14/wk
Author: patimwep
License: MIT
Types: skill
Size: 1.6 MB
Dependencies: 0 dependencies · 0 peers

Pi manifest JSON

{
  "skills": [
    "./skills/skills"
  ],
  "image": "https://raw.githubusercontent.com/Smotherer007/pi-cap-bestpractices/main/screenshot.png"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-cap-bestpractices

SAP CAP (Cloud Application Programming Model) skills for the pi coding agent.

This package ships the official, SAP-maintained capire/skills repository as a git submodule, making the curated CAP skills available to pi. The previous hand-written skill has been replaced by the upstream skills, which follow the same open Agent Skills standard that pi implements.

Included skills

Skill	Purpose
`cap-developer`	Build/extend CAP apps (Node.js & Java): project setup, CDS modeling, declarative annotations, custom handlers
`cap-add-remote-service`	Consume external services (Calesi pattern): consumption views, delegation & federation handlers
`cap-upgrade`	Upgrade a CAP project to a newer CDS version (`cds upgrade` + manual major-jump workflows)
`cap-trivia`	Interactive CAP trivia quiz (requires the CAP MCP server)

Installation

# From npm (once published)
pi install npm:@patimweb/pi-cap-bestpractices

# From local path during development
pi install /path/to/pi-cap-bestpractices

Usage

The skills are loaded on demand. Trigger them by working on CAP/CDS code, or explicitly:

/skill:cap-developer
/skill:cap-add-remote-service
/skill:cap-upgrade

Keeping the skills up to date

The skills are tracked as a submodule pinned to a specific upstream commit. To pull the latest SAP skills:

git submodule update --remote skills
# review, then commit the updated submodule pointer

When cloning this repo fresh (including in CI), initialize the submodule:

git clone --recurse-submodules git@github.com:Smotherer007/pi-cap-bestpractices.git
# or, after a normal clone:
git submodule update --init --recursive

Development

git submodule update --init --recursive   # first time
npm test                                  # validate every SKILL.md frontmatter
npm test:watch                            # run tests on change

Publishing as a pi Package

The package declares "pi.skills": ["./skills/skills"] (the upstream repo keeps its skills under a nested skills/ directory). CI initializes the submodule (submodules: recursive) before tests and release, so the skill content ships inside the npm tarball. Releases are automated via semantic-release on pushes to main (and pre-releases on next).

License

This package (packaging, workflows, config): MIT — Copyright Patrick Weppelmann.
The bundled skills (skills/): Apache-2.0 — Copyright SAP SE or an SAP affiliate company and capire/skills contributors. See skills/LICENSE and skills/LICENSES/.