Skip to content

Add Agent Skill for AI-assisted contributors#815

Open
cidrblock wants to merge 2 commits intoansible:develfrom
cidrblock:doc/agent-skills
Open

Add Agent Skill for AI-assisted contributors#815
cidrblock wants to merge 2 commits intoansible:develfrom
cidrblock:doc/agent-skills

Conversation

@cidrblock
Copy link
Copy Markdown
Contributor

@cidrblock cidrblock commented Mar 11, 2026

SUMMARY

Add a SKILL.md following the open Agent Skills standard
that encodes the project's contribution conventions for AI coding assistants.
This is the machine-readable companion to the contributor guide — it helps AI
tools automatically follow the same PR template, changelog format, build system
expectations, and code style documented for human contributors.

The skill is loaded on-demand by compatible AI agents (GitHub Copilot, VS Code
Copilot, Copilot CLI, and other skills-compatible tools) when working on
pylibssh code. It does not affect any existing workflows or tooling.

Contents:

  • Pre-contribution checklist (check existing work, review devel)
  • PR template and scope requirements
  • Changelog fragment format with available RST roles
  • Build system context (PEP 517 backend, Cython constraints, libssh dependency)
  • CI workflow structure
  • Code style conventions
ISSUE TYPE
  • Docs Pull Request
ADDITIONAL INFORMATION

Files changed:

  • .github/skills/pylibssh-contributing/SKILL.md — the Agent Skill
  • docs/changelog-fragments/815.contrib.rst — changelog fragment

Reference: Agent Skills in VS Code

Copilot AI review requested due to automatic review settings March 11, 2026 17:06
@psf-chronographer psf-chronographer Bot added the bot:chronographer:provided There is a change note present in this PR label Mar 11, 2026

This comment was marked as outdated.

Add a SKILL.md following the open Agent Skills standard
(agentskills.io) that encodes the project's contribution
conventions for AI coding assistants. This helps AI tools
follow the same PR template, changelog format, and build
system expectations documented in the contributor guide.

Made-with: Cursor
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

Comment thread docs/changelog-fragments/815.contrib.rst Outdated
Comment thread .github/skills/pylibssh-contributing/SKILL.md Outdated
Comment thread .github/skills/pylibssh-contributing/SKILL.md Outdated
Comment thread .github/skills/pylibssh-contributing/SKILL.md Outdated
Comment thread .github/skills/pylibssh-contributing/SKILL.md
… convention

- Cython constraints now match actual backend: >= 3.0.11 for Python >= 3.13
- .coveragerc description updated to reflect Cython.Coverage plugin
- Sign-off convention changed to -- by per documented standard
- Fixed backtick rendering in RST role example

Made-with: Cursor
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bot:chronographer:provided There is a change note present in this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants