Skip to content

docs: add Imported Skills section to README#143

Merged
marcusquinn merged 1 commit intomainfrom
docs/readme-skills-section
Jan 21, 2026
Merged

docs: add Imported Skills section to README#143
marcusquinn merged 1 commit intomainfrom
docs/readme-skills-section

Conversation

@marcusquinn
Copy link
Owner

@marcusquinn marcusquinn commented Jan 21, 2026

  • Document cloudflare-platform, remotion, and animejs skills
  • Add skill command reference (/add-skill)
  • Note automatic update tracking via skill-sources.json

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive "Imported Skills" section with details on externally sourced skills, their GitHub sources, and integration information.
    • Documented all available skill management commands including add, list, check for updates, and force update operations.
    • Introduced an updated skills overview table and expanded information about automatic update checks that occur during the setup process.

✏️ Tip: You can customize this high-level summary in your review settings.

- Document cloudflare-platform, remotion, and animejs skills
- Add skill command reference (/add-skill)
- Note automatic update tracking via skill-sources.json
@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 project's documentation by introducing a dedicated section in the README.md for 'Imported Skills'. This new content provides comprehensive information on external skills integrated into aidevops, detailing their origins, functionalities, and the command-line interface for managing them, thereby improving clarity and usability for developers.

Highlights

  • New Documentation Section: A new 'Imported Skills' section has been added to the README.md to detail how aidevops integrates and manages external skills.
  • Documented Skills: Specific skills such as cloudflare-platform, remotion, and animejs are now documented, including their sources and descriptions.
  • Skill Command Reference: A reference for /add-skill commands has been included, explaining how to import, list, check updates, and force-update skills.
  • Automatic Update Tracking: The documentation now clarifies that skill updates are automatically tracked via .agent/configs/skill-sources.json and checked during ./setup.sh.
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.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 21, 2026

Caution

Review failed

The pull request is closed.

Walkthrough

The pull request adds a new "Imported Skills" section to the README documenting externally sourced skills, including their GitHub sources, descriptions, usage commands (add/list/check-updates/force-update), and configuration references to .agent/configs/skill-sources.json.

Changes

Cohort / File(s) Summary
Documentation
README.md
Added "Imported Skills" section with skill command examples, GitHub source references, configuration details, and update workflow documentation (21 lines added). Positioned between existing quality control and agent design pattern sections.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

📚 Skills are imported, neat and bright,
Commands are listed, left and right,
A README shines with fresh delight,
Documentation takes its flight! ✨


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.

@sonarqubecloud
Copy link

@marcusquinn marcusquinn merged commit 6bef07b into main Jan 21, 2026
6 of 9 checks passed
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 adds a new 'Imported Skills' section to the README.md file, documenting skills imported from external repositories and the commands to manage them. My review focuses on improving the clarity and consistency of this new documentation. I've suggested clarifying the source and update mechanism for the animejs skill and making the parameter for the skill update command less ambiguous.

|-------|--------|-------------|
| **cloudflare-platform** | [dmmulroy/cloudflare-skill](https://github.com/dmmulroy/cloudflare-skill) | 60 Cloudflare products: Workers, Pages, D1, R2, KV, Durable Objects, AI, networking, security |
| **remotion** | [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video creation with React, animations, rendering |
| **animejs** | [Context7 docs](https://animejs.com) | JavaScript animation library patterns and API |

Choose a reason for hiding this comment

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

medium

The source [Context7 docs](https://animejs.com) is a bit confusing. It mixes the provider (Context7) with a link to the library's homepage, which is inconsistent with the other skills that link to GitHub repositories. This could be misleading for users, especially since the section description mentions "automatic update tracking." This likely doesn't apply to the animejs skill if it's not from a Git repository.

To improve clarity, I suggest clarifying in the description that this skill is provided via Context7.

Suggested change
| **animejs** | [Context7 docs](https://animejs.com) | JavaScript animation library patterns and API |
| **animejs** | [animejs.com](https://animejs.com) | JavaScript animation library patterns and API (provided via Context7) |

/add-skill <owner/repo> # Import a skill from GitHub
/add-skill list # List imported skills
/add-skill check-updates # Check for upstream updates
/add-skill <repo> --force # Update an existing skill

Choose a reason for hiding this comment

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

medium

The <repo> parameter in the /add-skill <repo> --force command is ambiguous. It's unclear whether it refers to the skill name from the table (e.g., cloudflare-platform) or the repository name from the source URL (e.g., cloudflare-skill). Using <skill-name> would be more explicit and align better with the table's 'Skill' column.

Suggested change
/add-skill <repo> --force # Update an existing skill
/add-skill <skill-name> --force # Update an existing skill

@augmentcode
Copy link

augmentcode bot commented Jan 21, 2026

🤖 Augment PR Summary

Summary: Adds an Imported Skills section to the README documenting curated external skills (Cloudflare Platform, Remotion, Anime.js) and their sources.
Notes: Includes a quick /add-skill command reference and mentions skill update tracking via skill-sources.json during ./setup.sh.

🤖 Was this summary useful? React with 👍 or 👎

Copy link

@augmentcode augmentcode bot left a comment

Choose a reason for hiding this comment

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

Review completed. 3 suggestions posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.

## **Imported Skills**

aidevops includes curated skills imported from external repositories, with automatic update tracking:

Copy link

Choose a reason for hiding this comment

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

The phrase "automatic update tracking" may overstate what happens for Context7-style imports: setup.sh skips update checks when upstream_commit is empty (noted as e.g. context7 imports). Consider clarifying that only skills with a recorded upstream commit are auto-checked.

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

/add-skill list # List imported skills
/add-skill check-updates # Check for upstream updates
/add-skill <repo> --force # Update an existing skill
```
Copy link

Choose a reason for hiding this comment

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

/add-skill <repo> --force looks inconsistent with the required owner/repo format (or full GitHub URL) used elsewhere; a bare <repo> likely won’t parse in the helper. Consider updating this example to /<add-skill> <owner/repo> --force for accuracy.

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

```

Skills are registered in `.agent/configs/skill-sources.json` and checked for updates during `./setup.sh`.

Copy link

Choose a reason for hiding this comment

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

setup.sh checks $HOME/.aidevops/agents/configs/skill-sources.json for update info, so saying skills are registered in .agent/configs/skill-sources.json could confuse users unless setup copies/syncs that file there first. Consider mentioning the installed path (or both paths) explicitly.

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

@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, 353 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Wed Jan 21 05:50:51 UTC 2026: Code review monitoring started
Wed Jan 21 05:50:52 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 353
Wed Jan 21 05:50:52 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Wed Jan 21 05:50:54 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 353
  • VULNERABILITIES: 0

Generated on: Wed Jan 21 05:52:14 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

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