salesforce-plugin

A dedicated plugin wrapper repo for Salesforce agent skills.

This repository is packaged as a Codex bundle plugin and is also intended to be publishable to ClawHub as an OpenClaw-compatible bundle package.

This repo is the plugin-side companion to the upstream skills repo at:

• dsouzaAnush/salesforce-skills

The split is intentional:

• salesforce-skills stays the reusable upstream source of truth for sf-* skills
• salesforce-plugin adds plugin-specific wrapper structure:
  • plugin manifest
  • future hooks, commands, and agents
  • generated manifests
  • plugin-specific routing metadata
  • upstream sync workflow

Host compatibility

• Codex reads the bundle from .codex-plugin/plugin.json
• ClawHub / OpenClaw can publish and install a generated bundle artifact rooted at package.json plus openclaw.bundle.json

The root package.json is intentionally additive packaging metadata. It does not change the Codex plugin behavior or the shipped Salesforce skills.

Layout

salesforce-plugin/
├── .codex-plugin/plugin.json
├── .agents/plugins/marketplace.json
├── salesforce.md
├── skills/
│   └── sf-*/ 
│       ├── overlay.yaml
│       ├── upstream/
│       │   └── ...
│       └── SKILL.md
├── scripts/
│   ├── sync_upstream_skills.py
│   ├── build_skills.py
│   ├── build_skill_manifest.py
│   ├── skill_utils.py
│   └── validate.py
├── generated/
├── hooks/
├── commands/
├── agents/
└── tests/

Upstream workflow

1. Sync current upstream skills:

python3 scripts/sync_upstream_skills.py

2. Rebuild top-level plugin skill outputs:

python3 scripts/build_skills.py
python3 scripts/build_skill_manifest.py

3. Build a publishable ClawHub artifact:

python3 scripts/build_clawhub_bundle.py --profile core

The default core profile keeps the plugin Codex-compatible while avoiding the sync-only files that caused ClawHub bundle publishes to fail in practice. It includes:

• root bundle manifests and plugin branding assets
• root agent metadata
• each skill's SKILL.md
• each skill's agents/openai.yaml

Larger profiles are available for testing:

• core-assets
• core-refs-assets
• runtime

At the moment, only the core profile is verified to publish cleanly to ClawHub for this repo.

4. Run stale-build checks:

python3 scripts/build_skills.py --check
python3 scripts/build_skill_manifest.py --check
python3 scripts/validate.py

5. Run tests:

pytest -q
pytest --cov=scripts --cov-report=term-missing -q

Current status

• The repo is scaffolded as a plugin root.
• Salesforce skills are synced from the local upstream checkout.
• Generated artifacts are tracked and validated for drift.
• Overlay metadata is intentionally minimal in v1, but the generated manifest now exposes structured routing metadata and prompt fixtures for eval-style checks.
• ClawHub publishing should use the generated dist/clawhub/core/ artifact instead of the full repo root.