You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@airflow.apache.org by "choo121600 (via GitHub)" <gi...@apache.org> on 2026/05/15 06:36:22 UTC

[PR] feat(list-skills): human-facing index that auto-generates from frontmatter [airflow-steward]

choo121600 opened a new pull request, #164:
URL: https://github.com/apache/airflow-steward/pull/164

   ## Why
   
   The repo currently exposes 21 skills, but lacks a quick human-facing
   way to discover them.
   
   Skill routing already relies on the live frontmatter `description`
   fields internally, but humans had no equivalent overview.
   
   ## What
   
   Adds a new `list-skills` skill. On `/list-skills`, it runs a small
   Python script which:
   
   - walks `.claude/skills/*/SKILL.md`,
   - parses frontmatter for `name` and `description`,
   - groups skills by family prefix (with `pr-management` registered as
     a two-token family in `KNOWN_TWO_TOKEN_FAMILIES`),
   - prints each skill with the first sentence of its description.
   
   The output is regenerated from the live filesystem on every run, so
   there is no separate index to maintain.
   
   ## Scope
   
   - Read-only on `.claude/skills/`.
   - No external content reads, state mutation, or security-checklist
     patterns triggered.
   - `tools/skill-validator` passes (`OK (no violations)`).
   - One new dir: `.claude/skills/list-skills/` (SKILL.md + script).
     No changes elsewhere.
   
   ## Test plan
   
   - [x] `python3 .claude/skills/list-skills/scripts/list_skills.py`
         → all 21 current skills listed under 5 families.
   - [x] `--verbose` flag produces the alternate two-line layout.
   - [x] `uv run --directory tools/skill-validator skill-validate`
         → no violations.
   
   <img width="1025" height="1221" alt="image" src="https://github.com/user-attachments/assets/ed30e4c8-e8b5-4285-a187-78cd860eecf4" />
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] feat(list-skills): human-facing index that auto-generates from frontmatter [airflow-steward]

Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk commented on PR #164:
URL: https://github.com/apache/airflow-steward/pull/164#issuecomment-4458761869

   OH wowowowwooow !  -> should we name it "list-steward-skills" (or soon when we rename "list-magpie-skills" ? 


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] feat(list-skills): human-facing index that auto-generates from frontmatter [airflow-steward]

Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk merged PR #164:
URL: https://github.com/apache/airflow-steward/pull/164


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] feat(list-skills): human-facing index that auto-generates from frontmatter [airflow-steward]

Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk commented on PR #164:
URL: https://github.com/apache/airflow-steward/pull/164#issuecomment-4459687828

   NICE!


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] feat(list-skills): human-facing index that auto-generates from frontmatter [airflow-steward]

Posted by "choo121600 (via GitHub)" <gi...@apache.org>.
choo121600 commented on PR #164:
URL: https://github.com/apache/airflow-steward/pull/164#issuecomment-4459050776

   Yeah, I think just `list-skills` could be a bit confusing
   `list-steward-skills` sounds better for now, and then we can do a bulk rename from `steward` --> `magpie` later on :)


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org