Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

adding-service-documentation

/adding-service-documentation

Dodaje lub aktualizuje dokumentację usług jednego kliknięcia Coolify w content/docs/services, zapisuje logo w public/images/services i regeneruje katalog usług.

Repozytorium
coolify-docs ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
24.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
6
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 24.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

Dodaje lub aktualizuje dokumentację usług jednego kliknięcia Coolify w content/docs/services, zapisuje logo w public/images/services i regeneruje katalog usług.

Oryginalny opis (EN)

Add or update Coolify one-click service documentation in content/docs/services/, store logos in public/images/services/, and regenerate the service catalog. Use for service pages and catalog updates; use adding-documentation-pages for other guides.

Jak działa

  1. Content Pipeline
  2. Workflow
  3. Service Frontmatter
  4. Related References
  5. Troubleshooting
Sekcje z nagłówków SKILL.md, w oryginale · 57 linii, 486 słów
Podgląd SKILL.md
---
name: adding-service-documentation
description: Add or update Coolify one-click service documentation in content/docs/services/, store logos in public/images/services/, and regenerate the service catalog. Use for service pages and catalog updates; use adding-documentation-pages for other guides.
allowed-tools: Read, Grep, Glob, Write, Bash
---

# Add Service Documentation

Create service pages in the current Fumadocs content tree. Read `CLAUDE.md` for repository commands and conventions.

## Content Pipeline

| Source or output | Purpose |
|---|---|
| `content/docs/services/{slug}.mdx` | Authored service page; the filename determines the slug |
| `public/images/services/` | Local service logos and screenshots |
| `src/generated/services.json` | Generated catalog data consumed by `src/components/data/services-list.tsx` |
| `content/docs/services/all.mdx` | Generated categorized directory |

Both generators use `scripts/services-data.mjs`. It reads the top-level `.mdx` files in `content/docs/services/`, resolves local icons, and derives availability from frontmatter and recognized warning titles. It excludes `all.mdx`, `index.mdx`, `overview.mdx`, `how-services-work.mdx`, and `what-is-a-service.mdx`.

**Do not hand-edit either generated output.** Run `bun run generate:services`. Generation also runs before `bun run dev`, `bun run build`, and `bun run types:check`. `bun run preview` serves the existing build without regenerating content.

## Workflow

1. Check the relevant Coolify revision's `templates/compose/` YAML for the service, deployment variants, metadata, and availability. Skip new catalog entries marked `# ignore: true`; use [disabling-services](../disabling-services/SKILL.md) when updating an existing unavailable service.
2. Download the upstream logo to `public/images/services/{slug}-logo.svg` (or its actual image extension). See [METADATA.md](./METADATA.md) and [IMAGES.md](./IMAGES.md).
3. Create `content/docs/services/{slug}.mdx`, starting from `templates/service.mdx` or [TEMPLATES.md](./TEMPLATES.md). Replace template placeholders and add the required catalog frontmatter.
4. Write the service description, verified setup details, and official links. Follow [DOCUMENTATION.md](./DOCUMENTATION.md).
5. Run `bun run generate:services`. Check that the slug appears in `src/generated/services.json` and, for an enabled service, in `content/docs/services/all.mdx` under the right category.
6. Verify the page at `http://localhost:3000/docs/services/{slug}` and its card in `/docs/services/overview`. When committing, include the authored page, any new assets, and both generated outputs.

Individual service pages are discovered by the catalog generator. Do not add every service to `content/docs/services/meta.json`; that file organizes the section's guides and catalog entry points.

## Service Frontmatter

```yaml
---
title: "Service Name"
description: "Short description for the service card and directory."
category: "Analytics"
icon: "/docs/images/services/service-name-logo.svg"
---
```

Use an existing category where possible. `icon` is optional when the logo resolver finds a matching local file. Set `disabled: true` to hide a service from both catalogs while keeping its page reachable. See [CATALOG.md](./CATALOG.md) for resolution order and availability rules.

The collector reads only top-level scalar fields. Nested `og` metadata is not used for the service card; see [FRONTMATTER.md](../_shared/FRONTMATTER.md) for the current SEO behavior.

## Related References

- [IMAGES.md](../_shared/IMAGES.md): public asset paths and supported image components.
- [LINKS.md](../_shared/LINKS.md): internal routes and external links.
- [CONTAINERS.md](../_shared/CONTAINERS.md): MDX callouts and other registered components.
- [TESTING.md](../TESTING.md): isolated generator checks and page verification.

## Troubleshooting

- **Missing service:** confirm the file is `content/docs/services/{slug}.mdx`, has frontmatter, and is not one of the excluded filenames. Check `disabled` and recognized warning titles before regenerating.
- **Missing icon:** check the actual file under `public/images/services/`, use a resolver-friendly filename, or set `icon` to an existing `/docs/images/services/...` URL. The generator warns about invalid icons.
- **Wrong grouping:** `category` is used verbatim. Inspect current categories in the generated JSON rather than creating a near-duplicate spelling.
Pliki w paczce (6)
  • CATALOG.md 4 KB
  • DOCUMENTATION.md 5 KB
  • IMAGES.md 3 KB
  • METADATA.md 3 KB
  • SKILL.md 4 KB
  • TEMPLATES.md 8 KB

Wersje

W bazie nie ma innych skilli o nazwie adding-service-documentation.

Migawka bazy z 13.11.2026 · wersja paczki 62bc72bd07c4 (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

  • 100update-docs
    Aktualizuje publiczną dokumentację w katalogu docs/public, gdy zmieniają się funkcje albo narzędzia w projekcie.
  • 100writing-docs
    Podpowiada, jak pisać i edytować dokumentację Remotion, w tym strony MDX w pakiecie docs.
  • 100writing-docs
    Pomaga pisać i edytować dokumentację Remotion: dodawanie stron, edycja plików MDX w packages/docs i tworzenie treści.
  • 100writing-docs
    Pomaga pisać i edytować dokumentację Remotion: dodawanie stron, edycja plików MDX w packages/docs i tworzenie treści.
  • 100writing-docs
    Pomaga pisać i edytować dokumentację Remotion: dodawanie stron, edycja plików MDX w packages/docs i tworzenie treści.
  • 100documentation
    Stosuje standardy dokumentacji przy zmianach kodu: pisze i przegląda dokumentację, docstringi i komentarze, opisuje publiczne API i zmiany widoczne dla użytkownika oraz poprawia README.

Uwagi i zgłoszenia

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