Skip to content

feat(api): standardize frontmatter, update validation, register 24 api skills#5

Open
gaurav0107 wants to merge 2 commits intoLambdaTest:mainfrom
gaurav0107:feat/api-skill-standardization
Open

feat(api): standardize frontmatter, update validation, register 24 api skills#5
gaurav0107 wants to merge 2 commits intoLambdaTest:mainfrom
gaurav0107:feat/api-skill-standardization

Conversation

@gaurav0107
Copy link
Copy Markdown

Summary

Depends on: #4 (api directory normalization) — merge that first

  • Adds languages, category (api-testing), license (MIT), and metadata to all 24 api SKILL.md files to match the test skill frontmatter standard
  • Updates validate_skills.py to scan api/ subdirectories and adds api-testing and api-design to valid categories
  • Registers all 24 api skills in skills_index.json with full descriptions including trigger keywords
  • Sorts all 70 skills alphabetically, updates total_skills from 46 to 70

Changes by area

Area What changed
24 api SKILL.md files Added standardized YAML frontmatter fields
scripts/validate_skills.py Added os.walk(api/) scanning, new categories, api in SKIP_DIRS
skills_index.json 70 skills (was 46), sorted, full descriptions, api-testing category

Validation

Skills found: 70
Errors: 0
Warnings: 46 (expected — api skills are lightweight single-file skills without playbooks)
✅ All skills pass validation!

Test plan

  • Run python3 scripts/validate_skills.py — expect 70 skills, 0 errors
  • Run python3 -c "import json; d=json.load(open('skills_index.json')); print(len(d['skills']))" — expect 70
  • Spot-check 2-3 api SKILL.md files for complete frontmatter (name, description, languages, category, license, metadata)

🤖 Generated with Claude Code

@harishrajora
Copy link
Copy Markdown
Contributor

@gaurav0107 I see similar changes here as in #4 about the smallcasing and normalizing of names. Please verify.

@SparshKesari , do we need the languages and other things in SKILL.md as provided by him in commit 2b87157?

gaurav0107 and others added 2 commits May 7, 2026 00:52
…-case

Addresses the review comment on PR LambdaTest#4 about rebasing onto api-skill/
after upstream's api/ -> api-skill/ rename (PR LambdaTest#6).

- Renames all 18 api-skill/ subdirectories from mixed-case with spaces
  to lowercase hyphen-case
- Renames references/ (plural) to reference/ (singular) for the 2 api
  skills that had playbook reference directories, matching repo convention
- Updates api-skill/README.md directory tree to reflect new structure
  and fixes relative links to CONTRIBUTING.md and LICENSE
- Fixes typo 'dcoumentation' -> 'documentation' in postman-to-newman

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
… in index

Rebased onto upstream's api/ -> api-skill/ rename (PR LambdaTest#6), applied on
top of PR LambdaTest#4's subdirectory normalization.

- Add languages, category (api-testing), license (MIT), and metadata
  to all 24 api-skill/ SKILL.md files to match the test-skill frontmatter
  standard already enforced by scripts/validate_skills.py for 46 non-api skills
- Update validate_skills.py to scan api-skill/ (was api/) and add
  api-design to VALID_CATEGORIES
- Add 'api-skill' to SKIP_DIRS so nested skills aren't double-counted
- Register all 24 api-skill entries in skills_index.json with full
  descriptions and trigger keywords
- Sort all 70 skills alphabetically, update total_skills to 70

Validation:
  Skills found: 70
  Errors: 0
  Warnings: 47 (expected — api-skills are single-file, no playbooks)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@gaurav0107 gaurav0107 force-pushed the feat/api-skill-standardization branch from 2b87157 to f86b2ff Compare May 6, 2026 19:31
@gaurav0107
Copy link
Copy Markdown
Author

@SparshKesari — on whether languages/category/license/metadata are needed: these are already the standard enforced by scripts/validate_skills.py — it warns on every skill missing any of them, and all 46 non-api skills already have them (see appium-skill, playwright-skill, etc.). The 24 api skills were the only ones missing. This PR just brings them up to the same bar so the validator stops warning.

Also rebased #4 and #5 onto main after the api/api-skill/ rename in #6 — both MERGEABLE now. Validator reports 70 skills, 0 errors.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants