CtrlK
BlogDocsLog inGet started
Tessl Logo

bridge

Capture cross-project connections on the fly. Use when you notice a shared pattern, people-bridge, knowledge cascade, narrative amplifier, or flywheel loop linking two projects. Persists structured YAML to a bridges directory. Triggers on: bridge, connects to, feeds into, same pattern as, cross-project link, archetype detection, bidirectional, one-way, active, potential, theoretical.

66

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered operational skill: fully concrete guidance, real validation guards on the write path, and exemplary progressive disclosure with a verified one-level-deep reference. The main cost is token efficiency — Key Behaviors, Anti-Patterns, and Usage Examples substantially overlap, and the body could shed a third of its length without losing any instruction.

Suggestions

Merge Key Behaviors into Anti-Patterns (or vice versa) — three of the six key behaviors are verbatim restatements of anti-pattern rules.

Trim Usage Examples to the one case not already derivable from the Commands table and Capture section (the bidirectional people-bridge detection), dropping the redundant list/map example.

Drop or demote the two background web links (Linking Your Thinking, YAML block scalars) to a single line — they spend tokens on context Claude does not need to execute the skill.

DimensionReasoningScore

Conciseness

Mostly operational, but there is real redundancy: Key Behaviors restates Anti-Patterns nearly verbatim ("Store verbatim. No reformulation" vs "NEVER reformulate"; "One-line capture response" vs "NEVER add unsolicited commentary"; "No GTD writes" vs "NEVER write to GTD"), and Usage Examples re-demonstrates what the Commands and Capture sections already specify. This fits the 'mostly efficient but could be tightened' anchor; not 4 because the duplication and marginal background links (LKT, YAML spec) are more than minor, not 2 because there is no padding that explains concepts Claude already knows.

3 / 5

Actionability

Everything is executable for an instruction-only skill: exact filename pattern `{date}-{seq}-{source}-to-{target}.yaml`, a complete YAML schema with field-by-field semantics, a 4-step argument-parse procedure, keyword rules for direction/strength detection, exact one-line response templates, and concrete display formats for list/map/stats including a mermaid example. Not below 5: the common cases (capture, explicit type, bidirectional detection) are each covered by a worked example.

5 / 5

Workflow Clarity

Each command has a numbered, clearly sequenced procedure with real checkpoints: the capture guard on workspace root, the config-missing warning, the mandatory seq check to prevent overwrites, and the duplicate check via `/bridge list`. Not 5 because there are no explicit error-recovery feedback loops (what to do after a warning fires is implied rather than specified); not 3 because validation guards for the risky write path (collisions, missing config, unknown aliases) are explicitly present.

4 / 5

Progressive Disclosure

The body is a genuine overview that defers the full archetype table and detection heuristics to references/archetype-detection.md, which exists in the bundle and is exactly the referenced content. The reference is one level deep and doubly well-signaled — inline with a when-to-load instruction ("load it before auto-detecting an archetype") and again in a References table with When-to-Use column. No content that belongs in a separate file is inlined.

5 / 5

Total

17

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person voice, explicit what-and-when structure, and a typed taxonomy of connections. The main weakness is a trigger list that mixes natural user phrases with internal schema vocabulary (field values like bidirectional/active/potential), which both dilutes trigger quality and slightly raises false-trigger risk.

Suggestions

Replace the schema-value trigger terms (bidirectional, one-way, active, potential, theoretical, archetype detection) with phrases a user would actually say, e.g. "same person on both projects", "this feeds that", "carries context between", "test bed for".

Mention the retrieval capabilities (list, map, stats) alongside capture and persist so the 'what' covers the full skill surface.

Trim the trigger list to the highest-precision phrases to reduce conflict risk with general conversation.

DimensionReasoningScore

Specificity

Concrete actions are stated — "Capture cross-project connections on the fly" and "Persists structured YAML to a bridges directory" — plus an enumeration of five bridge types ("shared pattern, people-bridge, knowledge cascade, narrative amplifier, or flywheel loop"). Not 5 because coverage is limited to capture/persist (list, map, stats capabilities go unmentioned); not 3 because it names the domain and more than two specific actions with a typed taxonomy.

4 / 5

Completeness

Explicitly answers both questions: what ("Capture cross-project connections... Persists structured YAML to a bridges directory") and when ("Use when you notice a shared pattern... linking two projects", plus a concrete trigger-term list). This matches the top anchor — both what and when with concrete trigger phrases — and exceeds the level-4 anchor whose 'when' is less explicit.

5 / 5

Trigger Term Quality

Includes genuinely natural phrases users would say — "connects to", "feeds into", "same pattern as", "cross-project link" — matching the good-coverage anchor. Not 5 because the trigger list is diluted with internal jargon/field values ("archetype detection", "bidirectional", "one-way", "active", "potential", "theoretical") that users would not naturally utter, and common synonyms are missing.

4 / 5

Distinctiveness Conflict Risk

A clear niche (cross-project bridge capture in a praxis/project-config system) with mostly distinct triggers like "people-bridge" and "archetype detection". Not 5 because the bare words "active", "potential", "theoretical", and "one-way" are generic and could fire in unrelated conversations; not 3 because the domain framing keeps overlap confined to closely related skills.

4 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
pantheon-org/tekhne
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.