add-derived-signal

Implement custom normalized ranking signals for TeaRAGs code reranking.

11|3|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/artk0de/TeaRAGs-MCP --skill add-derived-signal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-derived-signal
Source: https://github.com/artk0de/TeaRAGs-MCP/tree/main/.claude/skills/add-derived-signal
Command: npx skills add https://github.com/artk0de/TeaRAGs-MCP --skill add-derived-signal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill addresses the limitation of standard code search by allowing developers to define custom, normalized ranking signals that surface stable, high-quality, or specific code patterns during the reranking phase.

Core Features & Use Cases

  • Custom Signal Definition: Create normalized (0-1) metrics based on git history or static code analysis.
  • Flexible Trajectory Support: Implement signals for git-based metrics like churn and ownership, or static metrics like chunk size and documentation density.
  • Use Case: If you need your coding agent to prioritize code that has been stable for over a year, you can define a custom signal that calculates recency and dampens scores for frequently modified hotspots.

Quick Start

Use the add-derived-signal skill to create a new typescript file in the appropriate trajectory directory that implements the DerivedSignalDescriptor interface.

Frequently Asked Questions about add-derived-signal

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define custom code-ranking signals for RAG retrieval?

To define custom code-ranking signals for RAG, you implement the DerivedSignalDescriptor interface to create normalized 0-1 metrics based on git history or static code structure, then register them in the trajectory provider's signal array.

Can I use git metrics like churn and ownership to rerank code in RAG pipelines?

Yes, you can use git metrics like churn and ownership to rerank code in RAG pipelines. The skill facilitates integrating these domain-specific git history metrics into the retrieval pipeline as normalized signals to surface stable code.

What is the best way to prioritize stable code over frequently modified hotspots in a coding agent?

The best way to prioritize stable code over frequently modified hotspots is defining a custom signal that calculates recency from git history, dampening scores for high-churn files during the reranking phase of the retrieval pipeline.

Does TeaRAGs support integrating static code analysis metrics for reranking?

Yes, TeaRAGs supports static code analysis metrics for reranking. You can implement flexible trajectory signals for static metrics like chunk size and documentation density alongside git-based metrics within the retrieval pipeline.

How do I register a new derived signal in a TypeScript trajectory directory?

To register a new derived signal in TypeScript, create a file in the appropriate trajectory directory implementing the DerivedSignalDescriptor interface, then add the signal to the trajectory provider's signal array for pipeline integration.

When do I need custom normalized signals for code search?

You need custom normalized signals for code search when standard retrieval fails to surface specific code patterns, requiring domain-specific metrics like documentation quality or ownership to rank high-quality code accurately during reranking.