SkillSkilltypeA procedure an agent follows. Indexed here, never written here.See every one →What this type is →independently maintainedindependently maintainedoriginPublished by one person or a small company outside SAP. Says nothing about quality; the readings say that.See every one →

@patimweb/pi-cap-bestpractices

A package for the pi coding agent that distributes SAP's capire/skills, carrying the upstream repository as a git submodule since version 2.0.0 replaced the author's own skill.

A distribution wrapper, not a second opinion: version 2.0.0 replaced the author's own hand-written skill with the upstream SAP set, so what an agent reads here is capire/skills reached through pi's packaging.

Facts

Latestv2.0.0ReleasedLast pushLicenceMIT

Where it sits

Lives in
Provides
Agent guidanceCAPAgent guidancecapabilityPackaged knowledge you hand a coding agent so it gets a framework right unprompted — skills, rule files, instruction packs. Distinct from agent tooling, which is about building agentic features into your application, and from [agent access to your code](capability:agent-code-access), where the agent reads the real project instead of being handed a file about it.
Requires
capire/skillscapire/skillsartifactNamed as a dependency in its documentation.

Who is behind it

patimwebpatimwebPersonMaintains this
In the atlas: maintains 1
@Smotherer007
maintainer

Before choosing this

Conditions

PracticalFunctional boundary

If your tool reads the open skill standard directly, install capire/skills and skip the wrapper.

What it declares

Every artifact

Type
Skill
Origin
Independently maintained

As a skill

Distributed through
npm

Connections2

@patimweb/pi-cap-bestpractices connections@patimweb/pi-cap-bestpracticesPROVIDES→ provides1provides authoredAgent guidanceNEEDS→ needs1needs authoredcapire/skills

Install

npm add @patimweb/pi-cap-bestpractices

Derived from the package name. No recipe recorded; the README has the configuration.

README

quoted from Smotherer007/pi-cap-bestpractices under MIT, read
Smotherer007/pi-cap-bestpractices/README.mdOn GitHub

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

SkillPurpose
cap-developerBuild/extend CAP apps (Node.js & Java): project setup, CDS modeling, declarative annotations, custom handlers
cap-add-remote-serviceConsume external services (Calesi pattern): consumption views, delegation & federation handlers
cap-upgradeUpgrade a CAP project to a newer CDS version (cds upgrade + manual major-jump workflows)
cap-triviaInteractive 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/.
MIT, read

History

Latest

v2.0.0

Notes
  • feat!: replace hand-written skill with official capire/skills submodule (846b5ff)
BREAKING CHANGES
  • the sap-cap-best-practices skill is removed and replaced by the official SAP capire skills
  1. v1.0.0

    Notes
    Features
    • add SAP CAP best-practices skill (ff6d223)
3downloads per week, npm
Weekly downloads for @patimweb/pi-cap-bestpractices26 complete calendar weeks from 2026-04-27 to 2026-10-25; the latest total is 3.27 Apr – 3 May: 04 May – 10 May: 011 May – 17 May: 018 May – 24 May: 025 May – 31 May: 01 Jun – 7 Jun: 08 Jun – 14 Jun: 015 Jun – 21 Jun: 022 Jun – 28 Jun: 029 Jun – 5 Jul: 06 Jul – 12 Jul: 013 Jul – 19 Jul: 020 Jul – 26 Jul: 027 Jul – 2 Aug: 03 Aug – 9 Aug: 010 Aug – 16 Aug: 017 Aug – 23 Aug: 024 Aug – 30 Aug: 25531 Aug – 6 Sept: 147 Sept – 13 Sept: 914 Sept – 20 Sept: 2421 Sept – 27 Sept: 3428 Sept – 4 Oct: 255 Oct – 11 Oct: 712 Oct – 18 Oct: 219 Oct – 25 Oct: 3
Agent guidance
  1. sap-cx-developer-companionAgent skill for SAP Customer Experience APIs, CDS and errors
  2. capire/skillsAgent skills for CAP development, each a SKILL.md with references
  3. DanKromp/skillOverflowCollection of 41 agent skills, 37 for SAP development tasks
  4. cap-mtx-scaffoldAgent skill for CAP multitenancy scaffolding
  5. CAP GuardianCAP review skill for coding agents with gates and prohibitions
  6. WerkbankLocal desktop workspace for AI conversations with SAP connectors
  7. SAP Power for KiroSAP skills for the Kiro IDE
  8. SAP Developers MCPHosted MCP server of developers.sap.com tutorials and missions
  9. secondsky/sap-skillsForty SAP development plugins for coding agents

Details

Sources4
npm registrydiscovered here, keywords:sap-capchecked
npm registry, @patimweb/pi-cap-bestpracticesversion, releases, installschecked
github.com/git+https://github.com/Smotherer007/pi-cap-bestpractices.gittree, pushes, contributors, CIchecked
README.mdquoted, and what the entry declareschecked

Sources are graph entities: the same page may back several entries, and an unreachable source flags every row that rests on it.

Compatibility and provenance
latestv2.0.0
first release
releases and cadence2
discovered vianpm registry · keywords:sap-cap
first seen in the atlas
ecosystem and domaincap, ai-and-agents
Flavors2
Node.js
“Build/extend CAP apps (Node.js & Java)” — Smotherer007/pi-cap-bestpractices — READMEchecked
Java
“Build/extend CAP apps (Node.js & Java)” — Smotherer007/pi-cap-bestpractices — READMEchecked
History in the atlas1
  1. First seen.
For your agent
Ref
artifact:patimweb-pi-cap-bestpractices
JSON
/artifacts/patimweb-pi-cap-bestpractices.json
MCP
Connecting an agent