playbooks

home / skills / bdambrosio / cognitive_workbench / relate

relate skill

/src/tools/relate

This skill routes to the synthesize tool with format="comparison" to preserve behavior for legacy workflows.

npx playbooks add skill bdambrosio/cognitive_workbench --skill relate

Review the files below or copy the command above to add this skill to your agents.

Files (2)
Skill.md
386 B
---
name: relate
type: python
hidden: true
description: "DEPRECATED — use synthesize with format='comparison' instead. Routes to synthesize tool for backward compatibility."
---

# relate (DEPRECATED)

**Use `synthesize` with `format="comparison"` instead.** This tool is a backward-compatibility wrapper that routes to `synthesize`.

See `synthesize` documentation for full details.

Overview

This skill is a deprecated compatibility wrapper that routes requests to the synthesize tool with format='comparison'. It exists only to preserve behavior for older integrations. New code should call synthesize directly with the comparison format.

How this skill works

When invoked, the skill forwards input and parameters to the synthesize tool and sets format='comparison' to reproduce legacy output. It performs minimal validation and does not implement its own synthesis logic. Any options supported by synthesize are honored when passed through.

When to use it

  • Maintaining older projects that still call relate and cannot be updated immediately.
  • Gradual migration strategies where you update callers in stages.
  • CI jobs or scripts that depend on the legacy entrypoint and need short-term continuity.
  • Verifying that synthesize with format='comparison' reproduces previous outputs before refactoring.
  • Avoid for new development — call synthesize directly.

Best practices

  • Replace calls to relate with synthesize(format='comparison') in codebases as soon as feasible.
  • Run tests to confirm identical outputs after switching to synthesize directly.
  • Avoid adding new logic to the wrapper; keep it transient and simple.
  • Document the migration timeline for your team and prioritize updating public APIs.
  • Pin dependency versions while migrating to prevent unexpected changes in synthesize behavior.

Example use cases

  • A legacy service still calling relate while you stage a release that replaces it with synthesize.
  • Automated scripts that generate comparison reports and need a no-op compatibility layer during refactor.
  • A CI pipeline that temporarily redirects relate calls to synthesize to validate equivalence before deprecating the old endpoint.

FAQ

Is relate still supported?

relate is deprecated and provided only for backward compatibility. Use synthesize with format='comparison' instead.

Will the output change if I switch to synthesize directly?

It should not. relate simply forwards to synthesize with format='comparison', but you should run tests to confirm parity in your environment.