Skip to content

itdove/devaiflow#337: Add 'daf skills' command to list and inspect available skills#340

Merged
itdove merged 1 commit intomainfrom
337
Mar 31, 2026
Merged

itdove/devaiflow#337: Add 'daf skills' command to list and inspect available skills#340
itdove merged 1 commit intomainfrom
337

Conversation

@itdove
Copy link
Copy Markdown
Owner

@itdove itdove commented Mar 31, 2026

Jira Issue: #337

Description

This PR introduces a new daf skills command that enables users to discover and inspect available skills within the DevAIFlow CLI. The command provides two modes of operation:

  1. List mode: Running daf skills displays all available skills with brief descriptions
  2. Inspect mode: Running daf skills <skill-name> shows detailed information about a specific skill, including its full documentation and usage instructions

Technical changes:

  • Added new SkillsDiscoveryCommand class in devflow/cli/commands/skills_discovery_command.py to handle skill discovery and inspection logic
  • Integrated the new command into the main CLI parser in devflow/cli/main.py
  • Updated daf-cli and daf-help skill documentation to reflect the new command
  • Added comprehensive test coverage in tests/test_skills_discovery_command.py

This enhancement improves developer experience by making it easier to discover and understand available DevAIFlow skills without needing to reference external documentation.

Assisted-by: Claude

Testing

Steps to test

  1. Pull down the PR
  2. Install or update the DevAIFlow package in your local environment
  3. Run daf skills to list all available skills and verify the output shows skill names with descriptions
  4. Run daf skills daf-cli to inspect a specific skill and verify detailed documentation is displayed
  5. Run daf skills non-existent-skill to verify appropriate error handling for invalid skill names
  6. Verify the command integrates properly with existing daf --help output

Scenarios tested

  • Listed all available skills successfully showing correct names and descriptions
  • Inspected individual skills (daf-cli, daf-help, etc.) and verified full documentation is displayed
  • Validated error handling for non-existent skill names
  • Confirmed command appears in main CLI help documentation

Deployment considerations

  • This code change is ready for deployment on its own
  • This code change requires the following considerations before being deployed:

Implements #337:
- Add 'daf skills' command to list all available skills grouped by level
- Support inspect mode ('daf skills <skill-name>') for detailed view
- Add JSON output support via --json flag
- Skills sorted by name with descriptions from frontmatter
- Inspect mode shows location, file path, frontmatter, and content preview
- Handle skills at multiple levels with precedence warnings
- Update daf-cli and daf-help skill documentation
- Add comprehensive test coverage (14 tests, all passing)
- All 3629 existing tests still passing

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@itdove itdove marked this pull request as ready for review March 31, 2026 15:29
@itdove itdove merged commit fa2bc63 into main Mar 31, 2026
7 checks passed
@itdove itdove deleted the 337 branch March 31, 2026 15:29
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.

1 participant