* feat: add Data Cloud Code Extension and Schema skills
Add two new skills for Salesforce Data Cloud:
- datacloud_code_extension: develop, test, and deploy Python code extensions
- datacloud_schema: retrieve DLO and DMO schema information via REST APIs
* modify the skills name from - datacloud_code_extension → developing-datacloud-code-extension and datacloud_schema → getting-datacloud-schema
* updated getting-datacloud-schema
* fix: address PR #180 review feedback and validation errors
- Wrap description values in double quotes in both SKILL.md files
- Trim developing-datacloud-code-extension SKILL.md from 755 to 319 lines
- Move README.md and quick-reference.md to references/ directory
- Remove "Claude Code" references and hardcoded local paths
- Use relative script paths (scripts/get_dlo_schema.py)
- Move getting-datacloud-schema docs/README.md to references/
---------
Co-authored-by: Hemant Singh Bisht <hsinghbisht@salesforce.com>
* feat: add SLDS applying and auditing quality skills
Two new skills for SLDS v2 compliance:
- applying-slds: guides artifact selection, styling hooks, utilities, icons
- auditing-slds-quality: scored quality audit with linter + static analysis
Made-with: Cursor
* refactor: rename auditing-slds-quality skill to validating-slds
Renames the skill directory and updates all references in
applying-slds/SKILL.md and applying-slds/checklists.md.
Made-with: Cursor
* fix: improve accuracy and add manual review gate across SLDS skills
Correct hook families, badge modifiers, and severity levels; add a
manual review gate to validating-slds so automated grades alone cannot
declare production readiness; make analyze-quality.cjs portable with
explicit --hooks-index flag; remove dead parseYaml code; add version
field to all three skill frontmatters.
Made-with: Cursor
* chore: retrigger CI
Made-with: Cursor
* fix: quote YAML descriptions and improve color hook disambiguation
- Quote description frontmatter in all three skills for valid YAML
(inner double quotes now escaped)
- Strengthen Step 4 directive: MUST read color-hooks guide before
choosing a hook — linter suggestions are unranked
- Add surface vs surface-container disambiguation table
- Add accent hook context table and state progression
- Add standalone-component exception for surface classification
- Add modal background example to examples.md
- Remove redundant brand-button example (covered by new context table)
Made-with: Cursor
Apply review feedback from external PR #227:
- SKILL.md frontmatter: remove `license`, `compatibility`, and
`metadata` (author/version) fields per reviewer. Keeps only the
minimal `name`, `description`, `allowed-tools` frontmatter shape
used by newer sibling skills in afv-library.
- Remove internal Salesforce release references (`core-264`,
`core-262`) from user-facing docs (SKILL.md troubleshooting
table, bdt-node-catalog.md BusinessTypeEnum section) and from
bdt_analyze.py module docstring. External users should not see
internal release codenames; the schema reference stands on its
own with its capture date at the top of the catalog file.
- Fix test docstring path `afv-library/skills/explaining-...`
-> `afv-library/skills/data-cloud-bdt-expert` (missed in the
earlier rename commit).
No behavior change. All 92 tests pass.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Rename skill directory and frontmatter name from
`explaining-batch-data-transform` to `data-cloud-bdt-expert`
per internal PR reviewer feedback. A noun-form name (identifies
the skill by what it's about) is clearer than a gerund-form name
(describes what it does) for user-facing plugin/skill identity.
- skills/explaining-batch-data-transform/ -> skills/data-cloud-bdt-expert/
- SKILL.md frontmatter `name:` updated
- tests docstring path updated
No behavior change. All 92 tests pass.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Ports the 14 applicable round-2 fixes from the internal PRizm review to the
external afv-library source. (plugin.json finding #13 is internal-only and
does not apply here.)
Accepted fixes:
1 bdt_analyze.py select_definition: isinstance(index, int) -> type(index) is int
(reject bool subclass of int).
2 bdt_analyze.py cmd_formula: precompute upstream fields_produced map to
eliminate O(consumed x upstream) recomputation.
3 bdt_analyze.py topo_order: replace sort-on-every-iteration with deque-based
Kahn (preserves deterministic order).
4 test_bdt_analyze.py test_all_subcommands_work_on_api_input: wrap loop in
self.subTest for per-iteration failure reporting.
5 test_bdt_analyze.py test_invalid_json_raises: register addCleanup BEFORE
write_text so cleanup runs even if write fails.
6 SKILL.md: remove misleading "strip __c suffix" field-trace troubleshooting
advice; replace with source-DMO passthrough guidance.
7 SKILL.md: rewrite cycle error message to direct user to Data Cloud viewer
(re-export will not fix a cycle in the BDT definition).
8 SKILL.md: add explicit --definition N flag documentation and list every
subcommand that accepts it.
9 SKILL.md: refine I2 routing guidance — pick the earliest formula/
computeRelative node, not the output mapping.
11 bdt-function-catalog.md: clean floor() wording ("always rounds down on the
number line").
12 bdt-node-catalog.md: businessType enum — assert list is canonical/complete;
instruct skill to surface+flag any unknown value.
14 append_and_split.json: change split subject from fragile
CustomerFullName__c split-on-space to ChannelOrderKey__c split-on-hyphen;
avoids name-parsing pitfall (middle names / multi-space).
15 window_and_aggregate.json: use the computed OrderRank__c via a new
FIRST_ORDER_AMOUNT formula node (case when rank=1 then amount else 0)
feeding AGG_BY_ACCOUNT; illustrates the rank+formula+aggregate idiom.
16 joins_and_filters.json: add explicit IS_NOT_NULL filter expression on
GrandTotalAmount__c (defense-in-depth beyond GREATER_THAN 0).
Rejected finding (rationale posted as PR comment):
10 bdt-node-catalog.md split section — reviewer claimed split is a
pipeline-branching node. Canonical sources (core-262
SplitParametersInputRepresentation.java + Salesforce help DITA
c360_a_batch_transform_split.xml) both describe split as a
string-splitting operation. Current docs are correct; not changing.
Tests: 92/92 passing.
Addresses 4 critical findings surfaced during PRizm code review of the
internal plugin port of this skill (internal PR #19). Applying the same
fixes here keeps the external canonical source and the internal port in
sync.
1. Test cleanup discipline: switch `test_invalid_json_raises` from
`try/finally` to `self.addCleanup(p.unlink, missing_ok=True)` — the
unittest-idiomatic way to guarantee temp-file cleanup regardless of
how the test exits.
2. `floor()` description in bdt-function-catalog.md: the old row was
self-contradictory ("toward zero" AND "toward next integer up" in
the same cell). Replace with a single coherent definition: rounds
toward negative infinity; for negatives rounds away from zero
(e.g., `floor(-2.3) = -3`).
3. Split-node documentation in bdt-node-catalog.md: the old doc claimed
`split` routes rows into downstream branches via `branches[]` with
per-branch predicates. That is not the canonical schema. Per
`SplitParametersInputRepresentation` in core-262-public, `split` is
a string-splitting operation: one `sourceField` + `delimiter` →
N `targetFields` (one row in, one row out; columns added). Rewrote
the section with the correct parameters, lineage effect, gotchas,
and a canonical example. Row-routing belongs in `filter` nodes.
4. Sample `assets/sample_bdts/append_and_split.json`: the old sample
used the invented `branches[]` shape AND routed the same split into
two downstream outputs that each expected different rows — which is
not how `split` works. Rewrote the sample so:
- `appendV2` unions two order sources (unchanged intent).
- `split` uses canonical `{sourceField, delimiter, targetFields}`
splitting `CustomerFullName__c` into first + last name columns.
- One downstream output consumes the new columns (removes the
fake two-branch fan-out).
Tests: 92/92 passing. Sample parses and runs through `bdt_analyze.py
summary` cleanly (5 nodes: 2 load + 1 appendV2 + 1 split + 1 outputD360).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds the full test suite for bdt_analyze.py: 92 unit tests backed by
9 JSON fixtures (4 normative + 5 adversarial). All tests stdlib-only,
runnable via `python3 -m unittest tests.test_bdt_analyze`.
tests/test_bdt_analyze.py coverage:
DAG primitives:
- roots() / sinks() / topo_order() on minimal + branching graphs.
- upstream() / downstream() reachability correctness.
- Cycle tolerance: topo_order + traversals do not infinite-loop or
raise when the graph contains a cycle; cycle is reported via
broken_references-adjacent signals.
- Broken-reference tolerance: nodes referencing non-existent upstreams
are handled gracefully; broken_references() enumerates them.
CLI subcommands (happy-path + error-path for each):
- summary, sources, outputs, stages, nodes, node, lineage,
field-trace, formula, definitions — each exercised in both
human-readable and --json modes.
- Exit-code discipline: unknown node -> exit 2, malformed input ->
exit 3, success -> exit 0.
- Unknown-action graceful degradation: nodes whose action isn't in
the catalog still appear in summary/nodes output with a generic
label rather than crashing.
- Output size budgets: default-mode outputs are asserted to stay
within configured character caps.
Field discovery:
- fields_produced() / fields_consumed() / _scrape_field_refs()
heuristics tested against both clean and noisy formula bodies.
- TestFieldTraceFocus — narrowing tests preventing false-positive
substring hits in formula text.
Dual-shape input:
- TestInputShapeDetection — editor export vs. Connect API
single-definition auto-detection.
- TestMultiDefinition — Connect API multi-definition payload:
definitions subcommand, --definition N routing, out-of-range
index error handling.
Fixtures (tests/fixtures/):
- minimal.json — smallest valid editor-export BDT.
- window_and_aggregate.json — window + aggregate composition.
- api_input_single.json — Connect API single-definition payload.
- api_input_multi.json — Connect API multi-definition payload.
Adversarial fixtures (tests/fixtures/adversarial/):
- cycle.json — graph with a cycle; parser must not hang.
- broken_ref.json — node referencing a non-existent upstream.
- unknown_action.json — node with an action not in the catalog.
- no_ui.json — BDT missing the UI layer entirely.
- empty_nodes.json — valid envelope but zero nodes.
Suite status: Ran 92 tests, OK.
@W-22196528@
Adds the curated reference library the skill loads on demand, plus
four synthetic sample BDTs used by docs, tests, and LLM-mode demos.
references/ (4 curated Markdown files):
- bdt-reference.md — top-level BDT JSON anatomy: envelope,
nodes, edges, UI layer, definitions,
businessType semantics. Cites the core-262
upstream JSON schema and Connect API spec.
- bdt-node-catalog.md — every node type (DMO Source, DMO Sink,
Filter, Join, Union, Aggregate, Window,
Formula, Split, Append, etc.) with its
required/optional fields and typical
usage. Audited against core-262 enums.
- bdt-function-catalog.md — the expression-language function surface
(string, numeric, date, conditional,
aggregate). Grouped by category with
signature + one-line semantics.
- bdt-window-functions.md — windowing operators (ROW_NUMBER, RANK,
LEAD/LAG, running aggregates) with PARTITION
BY / ORDER BY grammar and gotchas.
assets/sample_bdts/ (4 synthetic, dependency-free BDTs):
- minimal_dmo_to_dmo.json — smallest valid BDT (1 source, 1 sink).
- joins_and_filters.json — join + filter composition.
- window_and_aggregate.json — window function + aggregate in one graph.
- append_and_split.json — append-then-split branching topology.
Grounding rules enforced in this commit:
- Every claim in references/ cites an upstream source (core-262 JSON
schema, Connect API reference, or the Data Cloud BDT editor spec).
No speculative content.
- No raw DITA or internal-only documentation is shipped; references
are synthesized from public-facing material.
- BusinessTypeEnum values use the canonical camelCase casing from
core-262 (case-cleanup fix included here).
- Sample BDTs are original synthetic fixtures, not redacted customer
data. Each is small enough to read end-to-end.
@W-22196528@
Adds scripts/bdt_analyze.py — a generic, stdlib-only DAG parser and
query CLI for Salesforce Data Cloud BDT JSON. 1,379 lines.
Parser primitives:
- DataTransform.from_path / from_dict — accepts three input shapes:
editor export ({version, nodes, ui, ...}), Connect API
single-definition ({name, label, type, definition: {...}}), and
Connect API multi-definition ({name, definitions: [{name, label,
type, definition}, ...]}).
- Node dataclass with ui_label / ui_description fallback resolution.
- roots() / sinks() / topo_order() — Kahn's algorithm with
deterministic tie-break for reproducible output.
- upstream() / downstream() traversal resilient to broken refs and
cycles (does not infinite-loop on self-edges or cycles).
- broken_references(), fields_produced(), fields_consumed(),
_scrape_field_refs() heuristics for field-trace discovery.
CLI (argparse, 10 subcommands, each supports --json for machine
output):
- summary — node counts, source/sink counts, stage totals.
- sources — list source nodes (no upstream).
- outputs — list sink nodes (no downstream).
- stages — topologically ordered stages.
- nodes — flat node listing with labels.
- node <name> — per-node detail (action, inputs, outputs, fields,
UI label/description).
- lineage <node> — upstream + downstream chain from a node.
- field-trace <field> — which nodes produce/consume a given field.
- formula <node> — extract formulas/expressions from a node.
- definitions — lists definitions in multi-definition
payloads; every other subcommand accepts
--definition N (default 0) to route into a
specific definition within the payload.
Error contract:
- Exit 0 on success, 2 on unknown node/field, 3 on malformed input.
- BdtInputError (exit 3) and BdtNotFoundError (exit 2) classes
centralize error handling so the CLI shell stays thin.
- Field-trace narrowing refinements prevent false positives from
substring matches in formula bodies.
- Upstream/downstream walkers harden against broken refs discovered
during internal-BDT audit.
Design invariants:
- Python owns truth (parsing, DAG math, field discovery). LLM owns
narrative (explaining what the structure means to a user).
- No external dependencies — stdlib only: argparse, json, pathlib,
re, sys, collections, dataclasses, typing.
- Output size budgets: every subcommand caps its default-mode output
so summaries fit in a single LLM context window; --json dumps
everything for agents that need raw data.
@W-22196528@
Scaffolds the explaining-batch-data-transform skill directory and delivers
the full, production-grade SKILL.md body. 194 lines.
Directory layout established (skills/explaining-batch-data-transform/):
- SKILL.md — the entry point this commit adds
- scripts/ — parser lands in commit 2
- references/, assets/ — reference docs + samples land in commit 3
- tests/ — unit tests + fixtures land in commit 4
SKILL.md frontmatter:
- name, description, tier, and owner fields matching the library's CI
validator schema.
- Description covers the full production surface: "Explain, audit, and
trace Salesforce Data Cloud Batch Data Transform (BDT) JSON — sources,
sinks, stages, lineage, field traces, formulas, multi-definition
payloads, and dual input shapes (editor export + Connect API)."
SKILL.md body (12 sections):
1. When to use this skill
2. Inputs you accept (editor export, Connect API single-definition,
Connect API multi-definition payloads)
3. Mode A — structural survey (summary / sources / outputs / stages)
4. Mode B — per-node explanation (nodes / node)
5. Mode C — lineage + field trace
6. Mode D — formulas and windows
7. Question routing table (user phrasing -> CLI subcommand)
8. Multi-definition payload handling (--definition flag semantics)
9. Troubleshooting (malformed JSON, unknown node refs, broken upstream)
10. Non-goals as explicit "Do not" directives (no execution, no schema
inference beyond what the JSON states, no speculation about runtime)
11. References + sample BDTs index
12. Exit-code + error-class contract surfaced from bdt_analyze.py
Structure passes the repo's skill-validator (npm run validate:skills):
single top-level H1, required sections present, frontmatter schema
aligned, no broken internal links.
@W-22196528@
* feat: add SLDS applying and auditing quality skills
Two new skills for SLDS v2 compliance:
- applying-slds: guides artifact selection, styling hooks, utilities, icons
- auditing-slds-quality: scored quality audit with linter + static analysis
Made-with: Cursor
* refactor: rename auditing-slds-quality skill to validating-slds
Renames the skill directory and updates all references in
applying-slds/SKILL.md and applying-slds/checklists.md.
Made-with: Cursor
* fix: improve accuracy and add manual review gate across SLDS skills
Correct hook families, badge modifiers, and severity levels; add a
manual review gate to validating-slds so automated grades alone cannot
declare production readiness; make analyze-quality.cjs portable with
explicit --hooks-index flag; remove dead parseYaml code; add version
field to all three skill frontmatters.
Made-with: Cursor
* chore: retrigger CI
Made-with: Cursor
* fix: quote YAML descriptions and improve color hook disambiguation
- Quote description frontmatter in all three skills for valid YAML
(inner double quotes now escaped)
- Strengthen Step 4 directive: MUST read color-hooks guide before
choosing a hook — linter suggestions are unranked
- Add surface vs surface-container disambiguation table
- Add accent hook context table and state progression
- Add standalone-component exception for surface classification
- Add modal background example to examples.md
- Remove redundant brand-button example (covered by new context table)
Made-with: Cursor
feat: replace agentforce-development skill with three specialized skills
Replace the monolithic agentforce-development skill with three focused skills:
- developing-agentforce: For creating and authoring Agentforce agents
- observing-agentforce: For monitoring and debugging agents
- testing-agentforce: For validating agent behavior
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
* fix: trigger ui-bundle skill for React application prompts
Add React-specific trigger language to building-ui-bundle-app description
so prompts like "I want to build a react application" activate the
ui-bundle orchestrator even without existing project files.
* fix: correct stale related-skill reference
Rename generating-experience-react-site to generating-ui-bundle-site
in building-ui-bundle-app related-skills to match the actual skill name.
* fix: tighten skill descriptions to reduce false triggers
- generating-ui-bundle-metadata: remove generic triggers (metadata, new app,
meta XML, configuration), update command to sf template generate ui-bundle,
add --template reactbasic flag
- building-ui-bundle-app: reframe as orchestrator for multi-skill ui-bundle
work, distinguish from generating-lightning-app
* fix: improve ui-bundle skill descriptions to reduce false triggers and improve activation
- Add MUST activate + file-pattern triggers to all 9 ui-bundle skills
- Remove overly specific examples that waste context tokens
- Scope features skill to authentication and search only
- Add boundary language between orchestrator and frontend skills
- Update metadata skill to use sf template generate ui-bundle --template reactbasic
* fix: standardize uiBundles/*/src/ directory trigger across all ui-bundle skills
* fix: remove React references from skill descriptions for framework agnosticism
* fix: standardize uiBundles/*/src/ trigger in agentforce and data skills
* fix: add 'Use this skill when' trigger context to all ui-bundle skill descriptions
* fix: require mobile-responsive UI in building-ui-bundle-frontend skill
* fix(using-ui-bundle-salesforce-data): condense reference into skill
also adds, operation types, script section type and mix instructions as comments in the examples. it also adds a section to avoid the llm being eager to show progress on ui-scaffold
* fix: workaround llm being eager to scaffold ui
* fix: delete testing with sf cli
* fix: add summary table for workflow steps
---------
Co-authored-by: Hemant Singh Bisht <hsinghbisht@salesforce.com>
* @W-21817314@ Improved lwr and ui bundle site's skill to identify what properties should be updated for when user request for site URL update
Signed-off-by: Daily Dai <lei.dai@salesforce.com>
* fix skill name
Signed-off-by: Daily Dai <lei.dai@salesforce.com>
* fix skill name
Signed-off-by: Daily Dai <lei.dai@salesforce.com>
* move url update into its own doc md file
Signed-off-by: Daily Dai <lei.dai@salesforce.com>
* clarify search_files is an agent tool instead of command line
Signed-off-by: Daily Dai <lei.dai@salesforce.com>
---------
Signed-off-by: Daily Dai <lei.dai@salesforce.com>
* Moving SKILL.md to generating-ui-bundle-site
* Rename configure-metadata-custom-site.md to configure-metadata-custom-site.md
* Rename configure-metadata-digital-experience-bundle.md to configure-metadata-digital-experience-bundle.md
* Moving configure-metadata-digital-experience-config.md to generating-ui-bundle-site
* Moving configure-metadata-digital-experience.md to generating-ui-bundle-site
* Moving configure-metadata-network.md to generating-ui-bundle-site
fix: derive router basename from <base href> at runtime
Add guidance to building-ui-bundle-frontend skill to always derive
the client-side router basename from the document's <base href> tag
instead of hardcoding it.
* Add building-ui-bundle-app orchestration skill
New orchestration skill that coordinates all UI bundle skills in proper
dependency order to build complete React applications on Salesforce.
Follows the generating-lightning-app pattern with explicit skill load
calls for each phase: scaffolding → features → data access → UI →
integrations → deployment → experience site.
* Clean up building-ui-bundle-app skill @W-21338965@
- Remove Skill Registry section (redundant with Dependency Graph + Execution Workflow)
- Remove "Skill to load" lines from Dependency Graph phases (duplicated in per-phase execution steps)
- Remove Best Practices 2 & 3 (duplicated in Execution Workflow and Phase 2 description)
- Fix SKILL LOAD ORDER numbering: flat 1-8 → 5a/5b to match phase numbering in Dependency Graph
- Clarify GraphQL schema re-fetch in Phase 6 is a post-deployment remote schema fetch
- Add parallel execution guidance to Phase 5 execution block
* Make Phase 2 (Features) optional @W-21338965@
* Address review feedback: use non-LWC terminology instead of React-specific
Co-authored-by: dme722
* Fix building-ui-bundle-app skill: remove special chars, align with actual skills
- Replace non-ASCII characters (arrows, circled numbers, checkmarks, em dashes)
that cause silent failures in Cline
- Fix incorrect skill name generating-ui-bundle-ui -> building-ui-bundle-frontend
- Align phase diagrams with actual skill workflows (add missing steps for
scaffolding npm install, features search-first flow, data validation step,
deployment final build and full post-deploy config)
- Fix Phase 4 diagram to match building-ui-bundle-frontend task categories
Made-with: Cursor
* Rename webapplication skills to ui-bundle
Rename all 7 webapplication skill directories and their content to use
the "ui-bundle" / "UIBundle" naming convention, aligning with the
New++ (TDX) naming strategy.
Directory renames:
- deploying-webapplication → deploying-ui-bundle
- generating-webapplication-{features,metadata,ui} → generating-ui-bundle-*
- implementing-webapplication-{agentforce-conversation-client,file-upload} → implementing-ui-bundle-*
- using-webapplication-salesforce-data → using-ui-bundle-salesforce-data
Content updates across all skills:
- Frontmatter name fields
- Prose: "web application" → "UI bundle"
- Metadata refs: WebApplication → UIBundle, webapplications/ → uiBundles/
- CLI: sf webapp → sf ui-bundle
- NPM packages per rename table
- Cross-skill references and generating-experience-react-site refs
* Rename generating-ui-bundle-ui skill to building-ui-bundle-frontend
The "ui-bundle-ui" name was confusing. "building-ui-bundle-frontend"
better conveys that this skill handles the React frontend layer
within a UI bundle.
---------
Co-authored-by: gbockus-sf <76090802+gbockus-sf@users.noreply.github.com>
* Split generating-webapp-metadata into single-purpose skills
Extract the deployment sequence into a new deploying-webapp skill so each
webapp skill describes exactly one actionable goal. This improves agent
skill selection accuracy by eliminating multi-concern descriptions.
- generating-webapp-metadata: now focused on scaffolding, bundle config, CSP
- deploying-webapp: new skill for the 7-step deployment sequence
* Rename -webapp- skill directories and references to -webapplication-
Rename all 7 webapp skill directories to use the full "webapplication"
entity name. Update frontmatter name fields, cross-skill references,
and descriptive prose. Package names and CLI commands are preserved
as-is since those are actual identifiers.
