45844de534
Consolidate the repository into clearer apps, tools, and layered docs areas so contributors can navigate and maintain it more reliably. Align validation, metadata sync, and CI around the same canonical workflow to reduce drift across local checks and GitHub Actions.
67 lines
2.0 KiB
Markdown
67 lines
2.0 KiB
Markdown
# Date Tracking Implementation Summary
|
|
|
|
This note explains how `date_added` support fits into the current repository structure after the `apps/` and `tools/` refactor.
|
|
|
|
## What Exists Today
|
|
|
|
### Frontmatter support
|
|
|
|
New skills can include a `date_added` field in `SKILL.md` frontmatter:
|
|
|
|
```yaml
|
|
---
|
|
name: skill-name
|
|
description: "Description"
|
|
date_added: "2026-03-06"
|
|
---
|
|
```
|
|
|
|
### Validator support
|
|
|
|
The active validators understand `date_added`:
|
|
|
|
- `tools/scripts/validate_skills.py` checks the `YYYY-MM-DD` format.
|
|
- Supporting JS validation/test helpers are aware of the field where relevant.
|
|
|
|
### Index and web app support
|
|
|
|
- `tools/scripts/generate_index.py` exports `date_added` into `skills_index.json`.
|
|
- `npm run app:setup` copies the generated index to `apps/web-app/public/skills.json`.
|
|
- The web app can render the field anywhere the UI surfaces it.
|
|
|
|
### Maintenance scripts
|
|
|
|
- `tools/scripts/manage_skill_dates.py` manages skill dates.
|
|
- `tools/scripts/generate_skills_report.py` produces JSON reports from current skill metadata.
|
|
|
|
## Canonical Documentation
|
|
|
|
The canonical docs for date tracking now live here:
|
|
|
|
- [`skills-date-tracking.md`](skills-date-tracking.md)
|
|
- [`../contributors/skill-template.md`](../contributors/skill-template.md)
|
|
- [`../contributors/skill-anatomy.md`](../contributors/skill-anatomy.md)
|
|
|
|
Use those files as the source of truth instead of older root-level doc names.
|
|
|
|
## Common Commands
|
|
|
|
```bash
|
|
# View current date coverage
|
|
python tools/scripts/manage_skill_dates.py list
|
|
|
|
# Add missing dates
|
|
python tools/scripts/manage_skill_dates.py add-missing
|
|
|
|
# Update one skill
|
|
python tools/scripts/manage_skill_dates.py update skill-name 2026-03-06
|
|
|
|
# Generate a report
|
|
python tools/scripts/generate_skills_report.py --output reports/skills_report.json
|
|
```
|
|
|
|
## Notes
|
|
|
|
- Repository-wide coverage can change over time as new community skills are added, so this document avoids hardcoding counts.
|
|
- `date_added` is useful metadata, but the operational contributor gate remains `npm run validate`; strict validation is a separate hardening target for legacy cleanup.
|