Przejdź do treści
Biblioteka skilli
DevOps i chmura · Analiza

template-usage

/template-usage

Śledzi zależności, użycie i adopcję szablonów Harness przez narzędzia MCP v2: znajduje pipeline'y odwołujące się do szablonu, ocenia wpływ aktualizacji, wykrywa nieużywane szablony i porównuje adopcję wersji.

Repozytorium
harness-skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
23.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 23.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Śledzi zależności, użycie i adopcję szablonów Harness przez narzędzia MCP v2: znajduje pipeline'y odwołujące się do szablonu, ocenia wpływ aktualizacji, wykrywa nieużywane szablony i porównuje adopcję wersji.

Oryginalny opis (EN)

Track Harness template dependencies, usage, and adoption via MCP v2 tools. Find which pipelines or other templates reference a given template, analyze update impact, identify unused templates, and compare version adoption. Use when asked about template usage, template references, template dependencies, impact analysis before updating a template, finding unused templates, or tracking template adoption across projects. Trigger phrases: template usage, who uses template, template references, template dependencies, template impact, unused templates, template adoption. Do NOT use for creating or up

Jak działa

  1. MCP v2 Tools Used
  2. Template Types
  3. Template Scopes
  4. Instructions
  5. Examples
  6. Error Handling
  7. Performance Notes
  8. Troubleshooting
Sekcje z nagłówków SKILL.md, w oryginale · 170 linii, 661 słów
Podgląd SKILL.md
---
name: template-usage
description: >-
  Track Harness template dependencies, usage, and adoption via MCP v2 tools. Find which pipelines
  or other templates reference a given template, analyze update impact, identify unused templates,
  and compare version adoption. Use when asked about template usage, template references, template
  dependencies, impact analysis before updating a template, finding unused templates, or tracking
  template adoption across projects. Trigger phrases: template usage, who uses template, template
  references, template dependencies, template impact, unused templates, template adoption. Do NOT use
  for creating or updating templates (use create-template instead).
metadata:
  author: Harness
  version: 1.0.0
  mcp-server: harness-mcp-v2
  summary: Template dependency tracking, impact analysis, and adoption
license: Apache-2.0
compatibility: Requires Harness MCP v2 server (harness-mcp-v2)
---

# Template Usage Skill

Track template dependencies and usage across Harness via MCP v2 tools.

## MCP v2 Tools Used

| Tool | Resource Type | Purpose |
|------|--------------|---------|
| `harness_search` | `template` | Find templates by keyword across orgs/projects |
| `harness_list` | `template` | List templates, filter by scope |
| `harness_get` | `template` | Get template details, versions, and usage references |
| `harness_describe` | `template` | Discover template resource schema and fields |

Templates are managed via `harness_list` and `harness_get` only. For creating or updating templates, use the `/create-template` skill.

## Template Types

| Type | Description |
|------|-------------|
| `Step` | Single step definition (build, test, deploy actions) |
| `Stage` | Complete stage with steps (CI stage, CD stage, approval) |
| `Pipeline` | Full pipeline definition |
| `StepGroup` | Group of related steps bundled together |

## Template Scopes

| Scope | Visibility | Query Parameters |
|-------|-----------|-----------------|
| Account | All orgs and projects | No org_id, no project_id |
| Organization | All projects in the org | org_id only |
| Project | Only within the project | org_id + project_id |

## Instructions

### Step 1: Find the Template

Search by name or keyword:

```
harness_search(
  query="docker-build-push",
  resource_types=["template"],
  max_per_type=10,
  compact=true
)
```

Or list templates in a specific scope:

```
harness_list(
  resource_type="template",
  org_id="<org>",
  project_id="<project>",
  search_term="docker"
)
```

### Step 2: Get Template Details

```
harness_get(
  resource_type="template",
  resource_id="<template_identifier>",
  org_id="<org>",
  project_id="<project>"
)
```

This returns the template definition, version history, and metadata.

### Step 3: Check Usage References

```
harness_get(
  resource_type="template",
  resource_id="<template_identifier>",
  org_id="<org>",
  project_id="<project>"
)
```

Parse the response for `referredEntities` or usage data. The response includes which pipelines and other templates reference this template.

### Step 4: Analyze and Present

Organize findings into a report.

For report templates (Usage Report, Impact Analysis, Unused Templates), consult references/report-templates.md.

## Examples

### Check who uses a template

```
/template-usage
Which pipelines are using the docker-build-push template?
```

### Impact analysis before update

```
/template-usage
I want to make a breaking change to the k8s-deploy template. Show me what will be affected.
```

### Find unused templates

```
/template-usage
Which templates in our account have no references? I want to clean up.
```

### Track version adoption

```
/template-usage
Which version of the ci-stage template are different projects using?
```

### Cross-project usage

```
/template-usage
Show me all usages of account-level templates across all projects
```

### Dependency chain

```
/template-usage
Show me the full dependency chain for the release-pipeline template --
what does it reference and what references it?
```

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| Template not found | Wrong identifier or scope | Verify identifier and use correct org_id/project_id for the template's scope |
| No usage data | Template genuinely unused or scope mismatch | Search at broader scope; account templates may be used in any project |
| Empty search results | No templates match query | Try broader search terms or list all templates |

## Performance Notes

- Paginate through all usage results before generating the impact report. Large templates may have many references.
- Check usage across all scopes (account, org, project) for complete impact analysis.
- Verify version information to distinguish between teams using current vs. outdated template versions.

## Troubleshooting

### No Usage Data Returned

1. Template may genuinely have no references
2. Query scope must match template scope -- an account-level template needs no org_id/project_id
3. Use `harness_search` with broader terms to find the template first

### Incomplete Usage List

1. Paginate through results -- increment `page` until all results are retrieved
2. Account-level templates can be referenced from any org/project -- check all scopes
3. Check for both pipeline and template references (templates can nest)

### Template Not Found

1. Verify the exact identifier (case-sensitive, underscores not hyphens)
2. Identifiers must match pattern: `^[a-zA-Z_][0-9a-zA-Z_]{0,127}$`
3. Check the correct scope -- project templates require org_id + project_id
Pliki w paczce (2)
  • SKILL.md 5 KB
  • references/report-templates.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie template-usage.

Migawka bazy z 13.11.2026 · wersja paczki 67f0d28344e2 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100create-template
    Generuje YAML szablonów Harness v0 dla komponentów wielokrotnego użytku (Step, Stage, Pipeline, StepGroup) i tworzy je przez MCP.
  • 100pr-analysis
    Analizuje wpływ pull requestów na pipeline'y Harness przez MCP, sprawdza PR pod kątem sekretów, podatności i zgodności oraz śledzi PR od merge do weryfikacji na produkcji.
  • 100add-adoption-tracking
    Śledzi adopcję funkcji w aplikacji React lub Next.js, mierzy używane i porzucane funkcje oraz podpowiada nudge'e dla funkcji o niskiej adopcji, z pakietem @tour-kit/adoption.
  • 100templates
    Tworzy, edytuje, wypycha i wersjonuje szablony Coder, na przykład dla Dockera, Kubernetes lub AWS, oraz wycofuje stare wersje.
  • 100update-cnw-templates
    Aktualizuje repozytoria szablonów CNW (create-nx-workspace) do docelowej wersji nx przez nx migrate, weryfikuje każde repozytorium i otwiera osobny pull request dla każdego.
  • 90sent-templates
    Wyświetla, wyszukuje, sprawdza i usuwa istniejące szablony w Sent przez narzędzia MCP: język, kanał, kategoria i status zatwierdzenia.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.