add new dev Claude Skill with some best practices (#95)

* add new dev skill

* update README

---------

Co-authored-by: Max Wang <zhaodongwang@microsoft.com>

Author: zhaodongwang-msft

.claude/skills/dataverse-sdk-dev/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: dataverse-sdk-dev
+description: Development guidance for contributing to the PowerPlatform Dataverse Client Python SDK repository. Use when working on SDK development tasks like adding features, fixing bugs, or writing tests.
+---
+
+# Dataverse SDK Development Guide
+
+## Overview
+
+This skill provides guidance for developers working on the PowerPlatform Dataverse Client Python SDK repository itself (not using the SDK).
+
+## Best Practices
+
+### API Design
+
+1. **All public methods in client.py** - Public API methods must be in client.py
+2. **Every public method needs README example** - Public API methods must have examples in README.md
+3. **Reuse existing APIs** - Always check if an existing method can be used before making direct Web API calls
+4. **Update documentation** when adding features - Keep README and SKILL files (both copies) in sync
+5. **Consider backwards compatibility** - Avoid breaking changes
+
+### Code Style
+
+6. **No emojis** - Do not use emoji in code, comments, or output
+7. **Standardize output format** - Use `[INFO]`, `[WARN]`, `[ERR]`, `[OK]` prefixes for console output
+8. **No noqa comments** - Do not add `# noqa: BLE001` or similar linter suppression comments
+9. **Document public APIs** - Add Sphinx-style docstrings with examples for public methods
+10. **Define __all__ in module files, not __init__.py** - Use `__all__` to control exports in the actual module file (e.g., errors.py), not in `__init__.py`.

.claude/skills/dataverse-sdk/SKILL.md .claude/skills/dataverse-sdk-use/SKILL.md.claude/skills/dataverse-sdk/SKILL.md renamed to .claude/skills/dataverse-sdk-use/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: powerplatform-dataverseclient-python
+name: dataverse-sdk-use
 description: Guidance for using the PowerPlatform Dataverse Client Python SDK. Use when calling the SDK like creating CRUD operations, SQL queries, table metadata management, and upload files.
 ---
 

README.md

@@ -63,13 +63,11 @@ pip install PowerPlatform-Dataverse-Client
 pip install PowerPlatform-Dataverse-Client && dataverse-install-claude-skill
 ```
 
-This installs a Claude Skill that enables Claude Code to:
-- Apply SDK best practices automatically
-- Provide context-aware code suggestions
-- Help with error handling and troubleshooting
-- Guide you through common patterns
+This installs two Claude Skills that enable Claude Code to:
+- **dataverse-sdk-use**: Apply SDK best practices for using the SDK in your applications
+- **dataverse-sdk-dev**: Provide guidance for developing/contributing to the SDK itself
 
-The skill works with both the Claude Code CLI and VSCode extension. Once installed, Claude will automatically use it when working with Dataverse operations. For more information on Claude Skill see https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview. See skill definition here: `.claude/skills/dataverse-sdk/SKILL.md`.
+The skills work with both the Claude Code CLI and VSCode extension. Once installed, Claude will automatically use the appropriate skill when working with Dataverse operations. For more information on Claude Skill see https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview. See skill definitions here: [.claude/skills/dataverse-sdk-use/SKILL.md](.claude/skills/dataverse-sdk-use/SKILL.md) and [.claude/skills/dataverse-sdk-dev/SKILL.md](.claude/skills/dataverse-sdk-dev/SKILL.md).
 
 For development from source (Claude Skill auto loaded):
 
@@ -365,6 +363,15 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope
 For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
 contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
 
+### API Design Guidelines
+
+When contributing new features to this SDK, please follow these guidelines:
+
+1. **All public methods in client.py** - Public API methods must be defined in [client.py](src/PowerPlatform/Dataverse/client.py)
+2. **Add README example for public methods** - Add usage examples to this README for public API methods
+3. **Document public APIs** - Include Sphinx-style docstrings with parameter descriptions and examples for all public methods
+4. **Update documentation** when adding features - Keep README and SKILL files (note that each skill has 2 copies) in sync
+
 ## Trademarks
 
 This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

pyproject.toml

@@ -61,7 +61,7 @@ namespaces = false
 
 [tool.setuptools.package-data]
 "*" = ["py.typed"]
-"PowerPlatform.Dataverse.claude_skill" = ["SKILL.md"]
+"PowerPlatform.Dataverse.claude_skill" = ["*/SKILL.md"]
 
 # Microsoft Python Standards - Linting & Formatting
 [tool.black]