known-issues

Document common agent mistakes and correct procedures for Azure DevOps workflows.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/jamesbondev/ai-dotfiles --skill known-issues-jamesbondev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: known-issues
Source: https://github.com/jamesbondev/ai-dotfiles/tree/main/.github/skills/known-issues
Command: npx skills add https://github.com/jamesbondev/ai-dotfiles --skill known-issues-jamesbondev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps prevent recurring errors and misunderstandings by documenting known agent mistakes and their correct resolutions, ensuring smoother and more efficient operations.

Core Features & Use Cases

  • Error Prevention: Provides a knowledge base of common pitfalls in script execution, Azure DevOps workflows, and coding practices.
  • Guidance: Offers clear instructions on correct behavior and configuration, especially regarding Azure DevOps environment variables and script arguments.
  • Use Case: Before running a new Azure DevOps script, consult this Skill to ensure you're not making a common mistake like passing the team name as a command-line argument instead of relying on environment variables.

Quick Start

Check the known issues before running any scripts or commands.

Frequently Asked Questions about known-issues

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I avoid common agent mistakes when running scripts in Azure DevOps?

To avoid common agent mistakes in Azure DevOps, consult a knowledge base of known issues before execution. It provides correct procedures for script arguments and environment variables, preventing recurring errors and ensuring smoother operational workflows.

Why does my Azure DevOps script fail when passing the team name as an argument?

Your Azure DevOps script fails because passing the team name as a command-line argument is a known agent mistake. You should rely on environment variables instead, ensuring correct configuration and adherence to documented operational procedures.

What is the correct way to use environment variables for Azure DevOps workflows?

The correct way to use environment variables in Azure DevOps workflows involves relying on them for configuration instead of command-line arguments. This prevents common agent mistakes and ensures adherence to documented rules for operational procedures.

What's the best way to troubleshoot script execution errors and agent mistakes?

The best way to troubleshoot script execution errors is to review documented known issues. This provides clear instructions on correct behavior, appropriate tool selection, and configuration to prevent recurring misunderstandings during operations.

Can I use this knowledge base to check tool selection rules before querying work items?

Yes, you can use this knowledge base to check tool selection rules before querying work items. It ensures adherence to documented rules and operational procedures, preventing common agent mistakes during Azure DevOps workflows.

When do I need to check known issues before running Azure DevOps commands?

You need to check known issues before running any new Azure DevOps commands or scripts. This prevents recurring errors by verifying correct behavior, environment variable usage, and appropriate tool selection for querying work items.