A curated collection of Agent Skills — modular knowledge packs that teach AI coding assistants domain-specific conventions, best practices, and architectural patterns.
Overview
A curated collection of — modular knowledge packs that teach AI coding assistants domain-specific conventions, best practices, and architectural patterns. Each skill is self-contained and can be installed independently into any project. This collection is actively growing — check back for new additions or contribute your own. This skill teaches AI agents how to work with SAP Commerce Cloud (Hybris) backend codebases. - 🏗️ extensions using the proper layered pattern (Type System → Services → Facades → OCC API) - 📋 in items.xml with correct deployment, typecodes, and modifiers - 🔧 beans, aliases, and overrides in *-spring.xml - 🌐 with controllers, WsDTOs, and DataMapper - 📦 through the OOTB patches framework and ImpEx - ✅ following the AAA pattern with JUnit 5 and Mockito - 🚀 using the correct Ant lifecycle commands - — items.
README
Agent Skills Collection
A curated collection of Agent Skills — modular knowledge packs that teach AI coding assistants domain-specific conventions, best practices, and architectural patterns. Each skill is self-contained and can be installed independently into any project.
Available Skills
| Skill | Description | Version | License |
|---|---|---|---|
| SAP Commerce Cloud Development | Guides SAP Commerce Cloud backend development: type system, ImpEx, Spring, OCC REST API, extensions, builds, and testing | 2.0 | Apache-2.0 |
| SAP Commerce Cloud CLI | Manage SAP Commerce Cloud Portal (CCV2) builds, deployments, data backups, data restores, and service properties via the sapccm CLI |
1.0 | Apache-2.0 |
| Personal Knowledge Wiki | Compiles personal data into a personal knowledge wiki for ingest, absorb, query, cleanup, and expansion workflows | - | - |
| Excalidraw Diagrams | Generates paste-ready Excalidraw JSON for flowcharts, architecture, sequence, mind map, wireframe, and 12 other diagram types — no server, API, or MCP required | - | - |
More skills coming soon. This collection is actively growing — check back for new additions or contribute your own.
📦 SAP Commerce Cloud Development
This skill teaches AI agents how to work with SAP Commerce Cloud (Hybris) backend codebases.
Highlights
- 🏗️ Architect extensions using the proper layered pattern (Type System → Services → Facades → OCC API)
- 📋 Define types in
items.xmlwith correct deployment, typecodes, and modifiers - 🔧 Configure Spring beans, aliases, and overrides in
*-spring.xml - 🌐 Build OCC REST endpoints with controllers, WsDTOs, and
DataMapper - 📦 Manage data through the OOTB patches framework and ImpEx
- ✅ Write tests following the AAA pattern with JUnit 5 and Mockito
- 🚀 Build & deploy using the correct Ant lifecycle commands
Key Conventions Enforced
| Rule | Why |
|---|---|
Never modify hybris/bin/platform/ or hybris/bin/modules/ |
These are SAP core — changes will be overwritten on upgrade |
Config goes in core-customize/hybris/config/ |
Project-specific config location |
ant clean all after items.xml changes |
Regenerates model classes from the type system |
ant updatesystem for DB schema changes |
Applies type and patch changes to the database |
| Typecodes are permanent | Never reuse or change a typecode once assigned |
| Override beans via ``, not by redefining | Preserves SAP’s bean wiring while allowing customization |
Reference Docs
- Type System — items.xml: types, enums, relations, deployment
- Patches & ImpEx — Patches framework, ImpEx syntax, macros, lifecycle
- Spring Configuration — Beans, aliases, overrides, list/map merge
- OCC REST API — Controllers, WsDTOs, beans.xml, DataMapper
- Testing — Unit tests, Mockito, AAA pattern
Agent Compatibility
This skill is compatible with any agent that supports filesystem-based skills or prompt packs, as long as the folder is installed in the path that agent expects and SKILL.md remains the entrypoint.
| Agent / Scope | Expected Path | Notes |
|---|---|---|
| Claude Code (personal/global) | ~/.claude/skills/sap-commerce-development/SKILL.md |
Standard personal skill location |
| Claude Code (project-local) | .claude/skills/sap-commerce-development/SKILL.md |
Shared with a specific repository |
| OpenAI-compatible setups | sap-commerce-development/agents/openai.yaml |
Optional adapter config for platforms that use OpenAI agent manifests |
| Other agents | Agent-specific skill directory | Install this skill folder wherever that agent loads custom skills |
🛠️ SAP Commerce Cloud CLI
This skill teaches AI agents how to operate the sapccm CLI tool to manage a CCV2 subscription on SAP Commerce Cloud Portal.
Highlights
- 🏗️ Create and monitor builds from any Git branch with live log streaming
- 🚀 Deploy builds to d1 / s1 / p1 environments with full control over update mode and deployment strategy
- 💾 Back up and restore data across environments with status polling
- 🔧 Inspect and update service properties (customer-properties, initial passwords, encryption keys)
- 🔐 Auth-failure recovery — prompts for updated client-id, client-secret, and token-url when credentials expire
Key Conventions Enforced
| Rule | Why |
|---|---|
Load .env before any command |
Keeps subscription/env codes out of history and code |
Confirm before cancel and delete |
Cancelling a deployment or deleting a backup is irreversible |
database-update-mode and strategy are case-sensitive |
CLI rejects lowercase values silently |
After service-properties put, click Apply Configurations in Cloud Portal |
A per-service Restart does not pick up property changes |
Set subscription-code globally via sapccm config set |
Avoids repeating it on every command |
Reference Docs
- Commands — Full syntax cheat sheet for every subcommand
- Service Codes — All service codes and property codes with editability notes
Agent Compatibility
| Agent / Scope | Expected Path | Notes |
|---|---|---|
| Claude Code (personal/global) | ~/.claude/skills/sap-cloud-cli/SKILL.md |
Standard personal skill location |
| Claude Code (project-local) | .claude/skills/sap-cloud-cli/SKILL.md |
Shared with a specific repository |
| OpenAI-compatible setups | sap-cloud-cli/agents/openai.yaml |
Optional adapter config |
| Other agents | Agent-specific skill directory | Install the skill folder wherever that agent loads custom skills |
Security: The
.envfile in the skill directory holds your subscription code and is git-ignored. Never commit it. If authentication fails, update the CLI credentials viasapccm config set client-id / client-secret / token-url.
📚 Personal Knowledge Wiki
This skill teaches AI agents how to compile journals, notes, messages, and other personal data into a structured personal knowledge wiki.
Highlights
- 📝 Ingest source data from formats like Day One, Apple Notes, Obsidian, Notion, email, CSV, and plain text
- 🧠 Absorb entries into articles by turning raw entries into connected wiki pages instead of flat archives
- 🔎 Query the wiki to answer questions from synthesized knowledge rather than re-reading source files
- 🧹 Clean up and expand articles with audits, backlink rebuilding, and missing-page detection
- 🗂️ Organize knowledge into a durable wiki structure with index, backlinks, and absorb logs
Key Workflows
| Command | Purpose |
|---|---|
/wiki ingest |
Convert source data into normalized markdown entries |
/wiki absorb [date-range] |
Compile raw entries into richer wiki articles |
/wiki query |
Answer questions by navigating the generated wiki |
/wiki cleanup |
Audit and improve article quality and structure |
/wiki breakdown |
Detect and create missing articles |
/wiki status |
Show overall wiki stats and progress |
Agent Compatibility
This skill is compatible with any agent that supports filesystem-based skills or prompt packs, as long as the folder is installed in the path that agent expects and SKILL.md remains the entrypoint.
| Agent / Scope | Expected Path | Notes |
|---|---|---|
| Claude Code (personal/global) | ~/.claude/skills/wiki/SKILL.md |
Standard personal skill location |
| Claude Code (project-local) | .claude/skills/wiki/SKILL.md |
Shared with a specific repository |
| Other agents | Agent-specific skill directory | Install this skill folder wherever that agent loads custom skills |
🎨 Excalidraw Diagrams
This skill teaches AI agents how to produce Excalidraw diagrams as clipboard JSON the user pastes straight onto the canvas. There is no canvas server, CLI, REST API, or MCP tool involved — the deliverable is a JSON file.
Highlights
- 🗂️ 17 diagram recipes — flowcharts, software architecture, sequence/UML/data-flow, mind maps, wireframes, Gantt charts, SWOT, lean canvas, personas, competitive matrices, brainstorm boards, presentation frames, and level/game maps
- 📐 Grid-planned layouts — tiers and x-positions decided before any JSON is emitted, everything snapped to a 20px grid
- 🎨 Design-system discipline — verified palette, matched stroke/fill pairs, max 4 accent colors each meaning one thing
- 🪣 Bucket fill regions — zone tinting, swimlane bands, and Gantt stripes via
polygonline elements instead of stacked translucent rectangles - ✅ Self-review pass — a 9-point static check (truncation, overlap, arrow geometry, crossings, spacing, reading order) before handover
Key Conventions Enforced
| Rule | Why |
|---|---|
Emit the excalidraw-api/clipboard skeleton format |
Excalidraw computes ids, seeds, text metrics, and bindings on paste |
Never hand-write seed, versionNonce, boundElements, or *Binding |
These are derived on paste; hand-written values corrupt the diagram |
Always give arrows explicit points |
width: 0 is read as unset and silently becomes a 100px diagonal |
Bind arrows via start / end {"id": "..."} |
Excalidraw re-routes them automatically when the user moves a box |
Labels go in label: {"text": ...}, not bare text |
Bare text is only valid on standalone type: "text" elements |
Width ≥ labelChars × 12 (rect), × 24 (diamond), × 17 (ellipse) |
Bound text sits in the inscribed box, not the bounding box |
Zone labels are free-standing text, never a bound label |
A bound label on a big rectangle centers in the middle of the zone |
| Place region fills before the elements that bound them | Keeps strokes and labels on top in the z-order |
| Never open a browser to test the output | Review is a static read of the JSON; the user does the visual check |
Reference Docs
- Design System — palette, typography, sizing, spacing, layering, anti-patterns
- Output Format — skeleton field reference, clipboard vs
.excalidrawfile, gotchas - Diagram Recipes — per-type layout recipes and conventions for all 17 diagram types
Usage
Ask for a diagram in plain language — “draw the checkout flow”, “diagram this service architecture”, “make a mind map of these ideas”. The agent writes a JSON file, then you paste it:
cat .json | pbcopy
Click an empty spot on the Excalidraw canvas, press Cmd/Ctrl+V, then Shift+1 to zoom to fit.
Agent Compatibility
| Agent / Scope | Expected Path | Notes |
|---|---|---|
| Claude Code (personal/global) | ~/.claude/skills/excalidraw-skill/SKILL.md |
Standard personal skill location |
| Claude Code (project-local) | .claude/skills/excalidraw-skill/SKILL.md |
Shared with a specific repository |
| Other agents | Agent-specific skill directory | Install this skill folder wherever that agent loads custom skills |
Repository Structure
.
├── .gitignore # Repository-level ignores
├── README.md # This file
├── sap-commerce-development/ # Skill package
│ ├── SKILL.md # Main skill definition
│ ├── LICENSE.txt # Apache 2.0 license
│ ├── agents/
│ │ └── openai.yaml # OpenAI agent config
│ └── reference/
│ ├── type-system.md
│ ├── patches.md
│ ├── spring-config.md
│ ├── occ-api.md
│ └── testing.md
├── sap-cloud-cli/ # Skill package
│ ├── SKILL.md # Main skill definition
│ ├── LICENSE.txt # Apache 2.0 license
│ ├── .env # Local secrets — git-ignored
│ ├── agents/
│ │ └── openai.yaml # OpenAI agent config
│ └── reference/
│ ├── commands.md # Full command syntax cheat sheet
│ └── service-codes.md # Service and property codes
├── wiki/ # Skill package
│ └── SKILL.md # Main skill definition
└── excalidraw-skill/ # Skill package
├── SKILL.md # Main skill definition
└── references/
├── design-system.md # Palette, typography, sizing, layering
├── output-format.md # Skeleton JSON field reference
└── diagram-recipes.md # 17 per-type layout recipes
Installation
Each skill can be installed individually. Copy or symlink the skill folder into the directory your agent uses for custom skills.
# Claude Code (personal/global)
mkdir -p ~/.claude/skills
cp -r /path/to/this-repo/sap-commerce-development ~/.claude/skills/
cp -r /path/to/this-repo/sap-cloud-cli ~/.claude/skills/
cp -r /path/to/this-repo/wiki ~/.claude/skills/
cp -r /path/to/this-repo/excalidraw-skill ~/.claude/skills/
# Claude Code (project-local)
mkdir -p .claude/skills
cp -r /path/to/this-repo/sap-commerce-development .claude/skills/
cp -r /path/to/this-repo/sap-cloud-cli .claude/skills/
cp -r /path/to/this-repo/wiki .claude/skills/
cp -r /path/to/this-repo/excalidraw-skill .claude/skills/
Note for
sap-cloud-cli: After copying, populate.envin the skill directory with your credentials. The file is already git-ignored in this repository.
Or add the entire collection as a Git submodule:
git submodule add agent-skills
ln -s agent-skills/sap-commerce-development .claude/skills/sap-commerce-development
ln -s agent-skills/wiki .claude/skills/wiki
ln -s agent-skills/excalidraw-skill .claude/skills/excalidraw-skill
Contributing
Contributions are welcome — whether improving existing skills or adding entirely new ones.
Improving an Existing Skill
- Fork the repository
- Edit the relevant files inside the skill’s directory
- Test by using the skill with your AI assistant on a real project
- Submit a pull request
Adding a New Skill
- Create a new folder under the root directory with a descriptive name
- Add a
SKILL.mdwith YAML frontmatter (name,description,license) and instructions - Add a
LICENSE.txtfor the skill - Optionally add agent-specific configs in an
agents/subdirectory - Update this root
README.mdto list the new skill in the Available Skills table
Guidelines
- Keep instructions concise and example-driven
- Use generic/anonymized names in code samples
- Include both the what and the why for every rule
- Each skill should be fully self-contained
License
Individual skills may have their own licenses and metadata inside each skill directory. The SAP Commerce Cloud Development skill is licensed under the Apache License 2.0.
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add flup-repo/skills