How do I install the Lang Python skill?

Run npx skillmds@latest add xiaolai/lang-python in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Lang Python safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Lang Python?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Lang Python free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Lang Python?

xiaolai (@xiaolai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Lang Python by xiaolai — Agent Skill

Name: Lang Python
Author: xiaolai

File contents

Python Language Adapter

Public API Detection

A symbol is public if:

It is listed in __all__ (if __all__ exists, only listed names are public)
Its name does not start with _ (single underscore = internal convention)
It is defined at module level or is a method of a public class

Priority

If __all__ exists → only those names are public
If __all__ does not exist → all non-underscore module-level names are public

Symbol Types to Document

Type	Detection	Documentation Expected
Functions	`def name(` at module level	Docstring with params, returns, raises
Classes	`class Name:` or `class Name(Base):`	Class docstring + `__init__` params
Methods	`def name(self` inside class, not `_`-prefixed	Docstring with params, returns
Constants	`NAME = value` (UPPER_CASE at module level)	Inline comment or module docstring mention
Type aliases	`Name = TypeAlias` or `type Name = ...`	Docstring or inline comment

Docstring Formats

Recognize and parse these formats:

Google Style

def foo(bar: int, baz: str) -> bool:
    """One-line summary.

    Args:
        bar: Description of bar.
        baz: Description of baz.

    Returns:
        True if successful.

    Raises:
        ValueError: If bar is negative.
    """

NumPy Style

def foo(bar, baz):
    """One-line summary.

    Parameters
    ----------
    bar : int
        Description of bar.
    baz : str
        Description of baz.

    Returns
    -------
    bool
        True if successful.
    """

Sphinx Style

def foo(bar, baz):
    """One-line summary.

    :param bar: Description of bar.
    :type bar: int
    :param baz: Description of baz.
    :returns: True if successful.
    :raises ValueError: If bar is negative.
    """

Documentation Completeness Check

A Python symbol is fully documented when:

Has a docstring (not empty)
All parameters are described
Return value is described (if not None)
Raised exceptions are listed (if any raise statements exist)

File Patterns

Source files: **/*.py (exclude __pycache__, *.pyc, test files)

---name: lang-pythondescription: Use when writing, auditing, or generating documentation for Python projects — covers docstring conventions, API doc extraction, and Python-specific patterns.---# Python Language Adapter## Public API DetectionA symbol is **public** if:1. It is listed in `__all__` (if `__all__` exists, only listed names are public)2. Its name does not start with `_` (single underscore = internal convention)3. It is defined at module level or is a method of a public class### Priority- If `__all__` exists → only those names are public- If `__all__` does not exist → all non-underscore module-level names are public## Symbol Types to Document| Type | Detection | Documentation Expected ||------|-----------|----------------------|| Functions | `def name(` at module level | Docstring with params, returns, raises || Classes | `class Name:` or `class Name(Base):` | Class docstring + `__init__` params || Methods | `def name(self` inside class, not `_`-prefixed | Docstring with params, returns || Constants | `NAME = value` (UPPER_CASE at module level) | Inline comment or module docstring mention || Type aliases | `Name = TypeAlias` or `type Name = ...` | Docstring or inline comment |## Docstring FormatsRecognize and parse these formats:### Google Style```pythondef foo(bar: int, baz: str) -> bool: """One-line summary. Args: bar: Description of bar. baz: Description of baz. Returns: True if successful. Raises: ValueError: If bar is negative. """```### NumPy Style```pythondef foo(bar, baz): """One-line summary. Parameters ---------- bar : int Description of bar. baz : str Description of baz. Returns ------- bool True if successful. """```### Sphinx Style```pythondef foo(bar, baz): """One-line summary. :param bar: Description of bar. :type bar: int :param baz: Description of baz. :returns: True if successful. :raises ValueError: If bar is negative. """```## Documentation Completeness CheckA Python symbol is **fully documented** when:1. Has a docstring (not empty)2. All parameters are described3. Return value is described (if not `None`)4. Raised exceptions are listed (if any `raise` statements exist)## File PatternsSource files: `**/*.py` (exclude `__pycache__`, `*.pyc`, test files)

Frequently asked questions

Lang Python