Skip to content

t1278: Interactive Skill Discovery & Management CLI (aidevops skills)#2030

Merged
marcusquinn merged 5 commits intomainfrom
feature/t1278
Feb 20, 2026
Merged

t1278: Interactive Skill Discovery & Management CLI (aidevops skills)#2030
marcusquinn merged 5 commits intomainfrom
feature/t1278

Conversation

@marcusquinn
Copy link
Owner

@marcusquinn marcusquinn commented Feb 20, 2026

WIP - incremental commits

Ref #1975

Summary by CodeRabbit

  • New Features

    • Introduced Skills Discovery command with interactive subcommands: search, browse, describe, info, list, categories, and recommend.
    • Users can explore and discover available skills through multiple discovery methods and receive personalized recommendations.
  • Documentation

    • Updated getting started guide with new skill discovery guidance.
    • Added comprehensive documentation for skill discovery workflows and command usage examples.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 20, 2026

Warning

Rate limit exceeded

@marcusquinn has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 25 minutes and 0 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

Walkthrough

Introduces a comprehensive skill discovery and management system featuring a new interactive CLI command (skills) integrated into the main aidevops.sh dispatcher, backed by a new skills-helper.sh utility script with search, browse, describe, info, list, categories, and recommend functionality, alongside documentation updates.

Changes

Cohort / File(s) Summary
Documentation & Reference
.agents/AGENTS.md, .agents/scripts/commands/skills.md
Updated agent reference table with Skills entry and expanded CLI usage guidance; added comprehensive skills command documentation including subcommand details and usage examples.
Skill Discovery Utility
.agents/scripts/skills-helper.sh
New Bash utility providing skill discovery and management with seven command implementations (search, browse, describe, info, list, categories, recommend), YAML frontmatter parsing, multi-format output support (human-readable/JSON), and imported vs. native skill differentiation.
CLI Integration & Manifest
aidevops.sh, .agents/subagent-index.toon
Integrated new cmd_skills() function into main CLI dispatcher with routing logic; updated help output to advertise Skill Discovery subsection; added skills-helper.sh entry to TOON:scripts manifest.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Poem

🔍 Skills now dance at your command,
Search and browse this wondrous land,
Discover, describe, categorize with flair,
DevOps automation beyond compare! ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 52.38% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The pull request title accurately and specifically summarizes the main change: introducing an interactive skill discovery and management CLI via the aidevops skills command.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feature/t1278

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions
Copy link

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 30 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Fri Feb 20 21:11:00 UTC 2026: Code review monitoring started
Fri Feb 20 21:11:00 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 30

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 30
  • VULNERABILITIES: 0

Generated on: Fri Feb 20 21:11:03 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

- Remove unused SUBAGENT_INDEX variable (SC2034)
- Replace local -A associative arrays with temp files for bash 3.2
- Add BOLD color constant missing from shared-constants.sh
- Add /skills and aidevops skills to AGENTS.md Skills section
- Add Skills row to progressive disclosure domain table
- Add skills to Getting Started CLI command list
- Update subagent-index.toon script count (81->82)
@marcusquinn marcusquinn marked this pull request as ready for review February 20, 2026 21:17
@gemini-code-assist
Copy link

Summary of Changes

Hello @marcusquinn, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the AI agent's capabilities by introducing a comprehensive interactive command-line interface for skill discovery and management. It allows users to easily find, explore, and understand the various AI agent skills available, improving usability and accessibility of the system's functionalities. The changes involve adding new scripts and updating existing documentation and the main CLI entry point to support these new features.

Highlights

  • New aidevops skills CLI Command: Introduced a new top-level CLI command aidevops skills for interactive skill discovery and management. This command provides functionalities such as searching, browsing, describing, listing, categorizing, and recommending AI agent skills.
  • Core Skill Discovery Logic: A new Bash script, skills-helper.sh, was added to implement the underlying logic for all skill discovery operations. This script handles parsing arguments, extracting skill metadata from markdown files, and formatting output.
  • Updated Documentation and CLI Help: The main AGENTS.md documentation was updated to reflect the new skills command and its capabilities. A dedicated markdown file, scripts/commands/skills.md, was also added to provide detailed documentation for the new command. The aidevops.sh help output was refined to differentiate between 'Skill Management' (aidevops skill) and 'Skill Discovery' (aidevops skills).
Changelog
  • .agents/AGENTS.md
    • Updated the CLI command list to include the new skills command.
    • Added a new section detailing skill discovery commands and their usage.
    • Included scripts/commands/skills.md in the full documentation reference.
  • .agents/scripts/commands/skills.md
    • Added a new markdown file documenting the interactive skill discovery and management CLI, including its workflow, commands, and conversational mode.
  • .agents/scripts/skills-helper.sh
    • Added a new Bash script that implements the core logic for skill discovery commands such as search, browse, describe, info, list, categories, and recommend.
  • .agents/subagent-index.toon
    • Registered the new skills-helper.sh script in the subagent index with its name and purpose.
  • aidevops.sh
    • Implemented the cmd_skills function to handle the new aidevops skills command, delegating execution to skills-helper.sh.
    • Updated the cmd_help function to include the new skills command and provide a clear distinction between skill management and skill discovery commands.
    • Modified the main function to dispatch to cmd_skills when the skills command is invoked.
Activity
  • The pull request is currently a Work In Progress (WIP) and contains incremental commits, indicating ongoing development.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@github-actions
Copy link

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 32 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Fri Feb 20 21:17:55 UTC 2026: Code review monitoring started
Fri Feb 20 21:17:56 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 32

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 32
  • VULNERABILITIES: 0

Generated on: Fri Feb 20 21:17:58 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new aidevops skills command for interactive skill discovery and management. The changes include a new helper script skills-helper.sh, updates to the main aidevops.sh CLI, and corresponding documentation. My review focuses on adherence to the repository's shell scripting style guide, robustness, and maintainability. I've identified several areas for improvement, including a high-severity issue with temporary file handling, inconsistent error suppression that violates project rules, and some minor inconsistencies. One comment regarding explicit return statements was removed as its suggestion contradicted an established rule. Applying these suggestions will make the new script more robust and aligned with the project's standards.

coderabbitai[bot]
coderabbitai bot previously requested changes Feb 20, 2026
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

🧹 Nitpick comments (1)
.agents/scripts/skills-helper.sh (1)

29-32: set -euo pipefail placed after source, and the BOLD comment is now stale.

Two nits here:

  1. source "${SCRIPT_DIR}/shared-constants.sh" runs without set -e active. If the file is missing, the script silently continues and fails later with a confusing "unbound variable" error on first color use, rather than a clear shared-constants.sh: not found message. Moving set -euo pipefail before the source call makes failures self-documenting.

  2. The comment on line 31 says "Bold not in shared-constants.sh — define locally", but the commit log records that BOLD was added to shared-constants.sh in this same PR. The local override is now redundant dead code.

♻️ Proposed fix
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
+set -euo pipefail
 source "${SCRIPT_DIR}/shared-constants.sh"
 
-set -euo pipefail
-
-# Bold not in shared-constants.sh — define locally
-BOLD='\033[1m'
-
 # Configuration
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.agents/scripts/skills-helper.sh around lines 29 - 32, Move the "set -euo
pipefail" line above the "source \"${SCRIPT_DIR}/shared-constants.sh\"" call so
the script fails fast and surfaces a clear missing-file error from
shared-constants.sh, and remove the now-redundant local BOLD definition and its
comment (since BOLD is defined in shared-constants.sh) to avoid overriding or
duplicating that constant; update the top of the script to enable strict mode
before sourcing and delete the BOLD variable and its comment where BOLD is
currently declared.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.agents/scripts/skills-helper.sh:
- Line 335: The three occurrences of echo wrapping a printf subshell (e.g. echo
"$(printf '=%.0s' $(seq 1 $((${`#category`} + 12))))") trigger ShellCheck SC2005;
replace each with a direct printf call followed by a bare echo for the newline —
e.g. use printf '=%.0s' $(seq 1 $((${`#category`} + 12))) and then echo — removing
the useless echo "$(printf ...)" subshell pattern in the functions/locations
that contain the shown printf expressions.
- Around line 42-60: The four logging functions (log_info, log_success,
log_warning, log_error) currently write to stdout which breaks --json consumers;
modify each function to emit its echo output to stderr instead (e.g., redirect
the echo to >&2 or use printf to >&2) while keeping the same messages and return
value so diagnostics go to stderr and stdout remains clean for JSON output.
- Around line 712-768: The cmd_categories function creates a tempfile via mktemp
but lacks a RETURN trap, so if the function exits early (e.g., under set -e) the
temp file leaks; add a trap 'RETURN' (matching the pattern used in cmd_browse)
immediately after creating cat_counts_file to ensure the temp file is removed on
any return/exit, and ensure the trap cleans up "$cat_counts_file" (and is
removed/reset if needed) so existing explicit rm -f at the end remains a no-op.

In @.agents/subagent-index.toon:
- Line 96: Update the TOON scripts block header so the declared count matches
the actual entries: change the header string
`<!--TOON:scripts[82]{name,purpose}:` to `<!--TOON:scripts[92]{name,purpose}:`
(the closing `-->` remains the same) so TOON parsers won't skip the last 10
script entries.

---

Nitpick comments:
In @.agents/scripts/skills-helper.sh:
- Around line 29-32: Move the "set -euo pipefail" line above the "source
\"${SCRIPT_DIR}/shared-constants.sh\"" call so the script fails fast and
surfaces a clear missing-file error from shared-constants.sh, and remove the
now-redundant local BOLD definition and its comment (since BOLD is defined in
shared-constants.sh) to avoid overriding or duplicating that constant; update
the top of the script to enable strict mode before sourcing and delete the BOLD
variable and its comment where BOLD is currently declared.

@marcusquinn marcusquinn dismissed coderabbitai[bot]’s stale review February 20, 2026 21:39

Auto-dismissed: bot review does not block autonomous pipeline

@github-actions
Copy link

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 32 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Fri Feb 20 21:58:49 UTC 2026: Code review monitoring started
Fri Feb 20 21:58:50 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 32

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 32
  • VULNERABILITIES: 0

Generated on: Fri Feb 20 21:58:52 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

@sonarqubecloud
Copy link

@marcusquinn marcusquinn merged commit 6492141 into main Feb 20, 2026
34 of 35 checks passed
@marcusquinn marcusquinn deleted the feature/t1278 branch February 20, 2026 22:22
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